Link documentation for all cluster commands

Added links to the documentation in the docstrings in redis/commands/cluster.py
Part of #1712

Author: enjoy-binbin

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 check 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 check 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 check 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 check 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 check 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 check 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 check 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 check 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 check https://redis.io/commands/swapdb
+        """
         raise RedisClusterException("SWAPDB is not supported in cluster" " mode")
 
 
@@ -193,6 +220,9 @@ def stralgo(
         withmatchlen=False,
         **kwargs,
     ):
+        """
+        For more information check 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"
@@ -281,6 +311,8 @@ def cluster_addslots(self, target_node, *slots):
 
         :target_node: 'ClusterNode'
             The node to execute the command on
+
+        For more information check https://redis.io/commands/cluster-addslots
         """
         return self.execute_command(
             "CLUSTER ADDSLOTS", *slots, target_nodes=target_node
@@ -306,13 +338,17 @@ 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 check https://redis.io/commands/cluster-countkeysinslot
         """
         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
+
+        For more information check https://redis.io/commands/cluster-count-failure-reports
         """
         return self.execute_command("CLUSTER COUNT-FAILURE-REPORTS", node_id)
 
@@ -322,6 +358,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 check https://redis.io/commands/cluster-delslots
         """
         return [self.execute_command("CLUSTER DELSLOTS", slot) for slot in slots]
 
@@ -343,6 +381,8 @@ def cluster_failover(self, target_node, option=None):
 
         :target_node: 'ClusterNode'
             The node to execute the command on
+
+        For more information check https://redis.io/commands/cluster-failover
         """
         if option:
             if option.upper() not in ["FORCE", "TAKEOVER"]:
@@ -361,36 +401,45 @@ 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 check https://redis.io/commands/cluster-info
         """
         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
+
+        For more information check https://redis.io/commands/cluster-keyslot
         """
         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.
+
+        For more information check https://redis.io/commands/cluster-meet
         """
         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
-
+        Get Cluster config for the node.
         Sends to random node in the cluster
+
+        For more information check 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 check https://redis.io/commands/cluster-replicate
         """
         return self.execute_command(
             "CLUSTER REPLICATE", node_id, target_nodes=target_nodes
@@ -402,6 +451,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 check https://redis.io/commands/cluster-reset
         """
         return self.execute_command(
             "CLUSTER RESET", b"SOFT" if soft else b"HARD", target_nodes=target_nodes
@@ -410,18 +461,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 check 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 check 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 check https://redis.io/commands/cluster-set-config-epoch
         """
         return self.execute_command(
             "CLUSTER SET-CONFIG-EPOCH", epoch, target_nodes=target_nodes
@@ -433,6 +490,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 check https://redis.io/commands/cluster-setslot
         """
         if state.upper() in ("IMPORTING", "NODE", "MIGRATING"):
             return self.execute_command(
@@ -447,13 +506,17 @@ 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 check https://redis.io/commands/cluster-setslot
         """
         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.
+
+        For more information check https://redis.io/commands/cluster-replicas
         """
         return self.execute_command(
             "CLUSTER REPLICAS", node_id, target_nodes=target_nodes
@@ -462,6 +525,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 check https://redis.io/commands/cluster-slots
         """
         return self.execute_command("CLUSTER SLOTS", target_nodes=target_nodes)
 
@@ -482,6 +547,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 check https://redis.io/commands/readonly
         """
         if target_nodes == "replicas" or target_nodes == "all":
             # read_from_replicas will only be enabled if the READONLY command
@@ -494,6 +561,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 check https://redis.io/commands/readwrite
         """
         # Reset read from replicas flag
         self.read_from_replicas = False