|
3 | 3 | import socket
|
4 | 4 | from collections import OrderedDict
|
5 | 5 | from contextlib import suppress
|
6 |
| -from typing import Any, Dict, Iterable, Iterator, List, Optional, Tuple, Union |
| 6 | +from typing import ( |
| 7 | + Any, |
| 8 | + Dict, |
| 9 | + Iterable, |
| 10 | + Iterator, |
| 11 | + List, |
| 12 | + Optional, |
| 13 | + Set, |
| 14 | + Tuple, |
| 15 | + Union, |
| 16 | + cast, |
| 17 | +) |
7 | 18 |
|
8 | 19 | from django.conf import settings
|
9 | 20 | from django.core.cache.backends.base import DEFAULT_TIMEOUT, BaseCache, get_key_func
|
10 | 21 | from django.core.exceptions import ImproperlyConfigured
|
11 | 22 | from django.utils.module_loading import import_string
|
12 | 23 | from redis import Redis
|
13 | 24 | from redis.exceptions import ConnectionError, ResponseError, TimeoutError
|
14 |
| -from redis.typing import AbsExpiryT, EncodableT, ExpiryT, KeyT |
| 25 | +from redis.typing import AbsExpiryT, EncodableT, ExpiryT, KeyT, PatternT |
15 | 26 |
|
16 | 27 | from django_redis import pool
|
17 | 28 | from django_redis.exceptions import CompressorError, ConnectionInterrupted
|
@@ -66,6 +77,14 @@ def __init__(self, server, params: Dict[str, Any], backend: BaseCache) -> None:
|
66 | 77 | def __contains__(self, key: KeyT) -> bool:
|
67 | 78 | return self.has_key(key)
|
68 | 79 |
|
| 80 | + def _has_compression_enabled(self) -> bool: |
| 81 | + return ( |
| 82 | + self._options.get( |
| 83 | + "COMPRESSOR", "django_redis.compressors.identity.IdentityCompressor" |
| 84 | + ) |
| 85 | + != "django_redis.compressors.identity.IdentityCompressor" |
| 86 | + ) |
| 87 | + |
69 | 88 | def get_next_client_index(
|
70 | 89 | self, write: bool = True, tried: Optional[List[int]] = None
|
71 | 90 | ) -> int:
|
@@ -498,6 +517,17 @@ def encode(self, value: EncodableT) -> Union[bytes, int]:
|
498 | 517 |
|
499 | 518 | return value
|
500 | 519 |
|
| 520 | + def _decode_iterable_result( |
| 521 | + self, result: Any, covert_to_set: bool = True |
| 522 | + ) -> Union[List[Any], None, Any]: |
| 523 | + if result is None: |
| 524 | + return None |
| 525 | + if isinstance(result, list): |
| 526 | + if covert_to_set: |
| 527 | + return {self.decode(value) for value in result} |
| 528 | + return [self.decode(value) for value in result] |
| 529 | + return self.decode(result) |
| 530 | + |
501 | 531 | def get_many(
|
502 | 532 | self,
|
503 | 533 | keys: Iterable[KeyT],
|
@@ -778,6 +808,257 @@ def make_pattern(
|
778 | 808 |
|
779 | 809 | return CacheKey(self._backend.key_func(pattern, prefix, version_str))
|
780 | 810 |
|
| 811 | + def sadd( |
| 812 | + self, |
| 813 | + key: KeyT, |
| 814 | + *values: Any, |
| 815 | + version: Optional[int] = None, |
| 816 | + client: Optional[Redis] = None, |
| 817 | + ) -> int: |
| 818 | + if client is None: |
| 819 | + client = self.get_client(write=True) |
| 820 | + |
| 821 | + key = self.make_key(key, version=version) |
| 822 | + encoded_values = [self.encode(value) for value in values] |
| 823 | + return int(client.sadd(key, *encoded_values)) |
| 824 | + |
| 825 | + def scard( |
| 826 | + self, |
| 827 | + key: KeyT, |
| 828 | + version: Optional[int] = None, |
| 829 | + client: Optional[Redis] = None, |
| 830 | + ) -> int: |
| 831 | + if client is None: |
| 832 | + client = self.get_client(write=False) |
| 833 | + |
| 834 | + key = self.make_key(key, version=version) |
| 835 | + return int(client.scard(key)) |
| 836 | + |
| 837 | + def sdiff( |
| 838 | + self, |
| 839 | + *keys: KeyT, |
| 840 | + version: Optional[int] = None, |
| 841 | + client: Optional[Redis] = None, |
| 842 | + ) -> Set[Any]: |
| 843 | + if client is None: |
| 844 | + client = self.get_client(write=False) |
| 845 | + |
| 846 | + nkeys = [self.make_key(key, version=version) for key in keys] |
| 847 | + return {self.decode(value) for value in client.sdiff(*nkeys)} |
| 848 | + |
| 849 | + def sdiffstore( |
| 850 | + self, |
| 851 | + dest: KeyT, |
| 852 | + *keys: KeyT, |
| 853 | + version_dest: Optional[int] = None, |
| 854 | + version_keys: Optional[int] = None, |
| 855 | + client: Optional[Redis] = None, |
| 856 | + ) -> int: |
| 857 | + if client is None: |
| 858 | + client = self.get_client(write=True) |
| 859 | + |
| 860 | + dest = self.make_key(dest, version=version_dest) |
| 861 | + nkeys = [self.make_key(key, version=version_keys) for key in keys] |
| 862 | + return int(client.sdiffstore(dest, *nkeys)) |
| 863 | + |
| 864 | + def sinter( |
| 865 | + self, |
| 866 | + *keys: KeyT, |
| 867 | + version: Optional[int] = None, |
| 868 | + client: Optional[Redis] = None, |
| 869 | + ) -> Set[Any]: |
| 870 | + if client is None: |
| 871 | + client = self.get_client(write=False) |
| 872 | + |
| 873 | + nkeys = [self.make_key(key, version=version) for key in keys] |
| 874 | + return {self.decode(value) for value in client.sinter(*nkeys)} |
| 875 | + |
| 876 | + def sinterstore( |
| 877 | + self, |
| 878 | + dest: KeyT, |
| 879 | + *keys: KeyT, |
| 880 | + version: Optional[int] = None, |
| 881 | + client: Optional[Redis] = None, |
| 882 | + ) -> int: |
| 883 | + if client is None: |
| 884 | + client = self.get_client(write=True) |
| 885 | + |
| 886 | + dest = self.make_key(dest, version=version) |
| 887 | + nkeys = [self.make_key(key, version=version) for key in keys] |
| 888 | + return int(client.sinterstore(dest, *nkeys)) |
| 889 | + |
| 890 | + def smismember( |
| 891 | + self, |
| 892 | + key: KeyT, |
| 893 | + *members, |
| 894 | + version: Optional[int] = None, |
| 895 | + client: Optional[Redis] = None, |
| 896 | + ) -> List[bool]: |
| 897 | + if client is None: |
| 898 | + client = self.get_client(write=False) |
| 899 | + |
| 900 | + key = self.make_key(key, version=version) |
| 901 | + encoded_members = [self.encode(member) for member in members] |
| 902 | + |
| 903 | + return [bool(value) for value in client.smismember(key, *encoded_members)] |
| 904 | + |
| 905 | + def sismember( |
| 906 | + self, |
| 907 | + key: KeyT, |
| 908 | + member: Any, |
| 909 | + version: Optional[int] = None, |
| 910 | + client: Optional[Redis] = None, |
| 911 | + ) -> bool: |
| 912 | + if client is None: |
| 913 | + client = self.get_client(write=False) |
| 914 | + |
| 915 | + key = self.make_key(key, version=version) |
| 916 | + member = self.encode(member) |
| 917 | + return bool(client.sismember(key, member)) |
| 918 | + |
| 919 | + def smembers( |
| 920 | + self, |
| 921 | + key: KeyT, |
| 922 | + version: Optional[int] = None, |
| 923 | + client: Optional[Redis] = None, |
| 924 | + ) -> Set[Any]: |
| 925 | + if client is None: |
| 926 | + client = self.get_client(write=False) |
| 927 | + |
| 928 | + key = self.make_key(key, version=version) |
| 929 | + return {self.decode(value) for value in client.smembers(key)} |
| 930 | + |
| 931 | + def smove( |
| 932 | + self, |
| 933 | + source: KeyT, |
| 934 | + destination: KeyT, |
| 935 | + member: Any, |
| 936 | + version: Optional[int] = None, |
| 937 | + client: Optional[Redis] = None, |
| 938 | + ) -> bool: |
| 939 | + if client is None: |
| 940 | + client = self.get_client(write=True) |
| 941 | + |
| 942 | + source = self.make_key(source, version=version) |
| 943 | + destination = self.make_key(destination) |
| 944 | + member = self.encode(member) |
| 945 | + return bool(client.smove(source, destination, member)) |
| 946 | + |
| 947 | + def spop( |
| 948 | + self, |
| 949 | + key: KeyT, |
| 950 | + count: Optional[int] = None, |
| 951 | + version: Optional[int] = None, |
| 952 | + client: Optional[Redis] = None, |
| 953 | + ) -> Union[Set, Any]: |
| 954 | + if client is None: |
| 955 | + client = self.get_client(write=True) |
| 956 | + |
| 957 | + nkey = self.make_key(key, version=version) |
| 958 | + result = client.spop(nkey, count) |
| 959 | + return self._decode_iterable_result(result) |
| 960 | + |
| 961 | + def srandmember( |
| 962 | + self, |
| 963 | + key: KeyT, |
| 964 | + count: Optional[int] = None, |
| 965 | + version: Optional[int] = None, |
| 966 | + client: Optional[Redis] = None, |
| 967 | + ) -> Union[List, Any]: |
| 968 | + if client is None: |
| 969 | + client = self.get_client(write=False) |
| 970 | + |
| 971 | + key = self.make_key(key, version=version) |
| 972 | + result = client.srandmember(key, count) |
| 973 | + return self._decode_iterable_result(result, covert_to_set=False) |
| 974 | + |
| 975 | + def srem( |
| 976 | + self, |
| 977 | + key: KeyT, |
| 978 | + *members: EncodableT, |
| 979 | + version: Optional[int] = None, |
| 980 | + client: Optional[Redis] = None, |
| 981 | + ) -> int: |
| 982 | + if client is None: |
| 983 | + client = self.get_client(write=True) |
| 984 | + |
| 985 | + key = self.make_key(key, version=version) |
| 986 | + nmembers = [self.encode(member) for member in members] |
| 987 | + return int(client.srem(key, *nmembers)) |
| 988 | + |
| 989 | + def sscan( |
| 990 | + self, |
| 991 | + key: KeyT, |
| 992 | + match: Optional[str] = None, |
| 993 | + count: Optional[int] = 10, |
| 994 | + version: Optional[int] = None, |
| 995 | + client: Optional[Redis] = None, |
| 996 | + ) -> Set[Any]: |
| 997 | + if self._has_compression_enabled() and match: |
| 998 | + err_msg = "Using match with compression is not supported." |
| 999 | + raise ValueError(err_msg) |
| 1000 | + |
| 1001 | + if client is None: |
| 1002 | + client = self.get_client(write=False) |
| 1003 | + |
| 1004 | + key = self.make_key(key, version=version) |
| 1005 | + |
| 1006 | + cursor, result = client.sscan( |
| 1007 | + key, |
| 1008 | + match=cast(PatternT, self.encode(match)) if match else None, |
| 1009 | + count=count, |
| 1010 | + ) |
| 1011 | + return {self.decode(value) for value in result} |
| 1012 | + |
| 1013 | + def sscan_iter( |
| 1014 | + self, |
| 1015 | + key: KeyT, |
| 1016 | + match: Optional[str] = None, |
| 1017 | + count: Optional[int] = 10, |
| 1018 | + version: Optional[int] = None, |
| 1019 | + client: Optional[Redis] = None, |
| 1020 | + ) -> Iterator[Any]: |
| 1021 | + if self._has_compression_enabled() and match: |
| 1022 | + err_msg = "Using match with compression is not supported." |
| 1023 | + raise ValueError(err_msg) |
| 1024 | + |
| 1025 | + if client is None: |
| 1026 | + client = self.get_client(write=False) |
| 1027 | + |
| 1028 | + key = self.make_key(key, version=version) |
| 1029 | + for value in client.sscan_iter( |
| 1030 | + key, |
| 1031 | + match=cast(PatternT, self.encode(match)) if match else None, |
| 1032 | + count=count, |
| 1033 | + ): |
| 1034 | + yield self.decode(value) |
| 1035 | + |
| 1036 | + def sunion( |
| 1037 | + self, |
| 1038 | + *keys: KeyT, |
| 1039 | + version: Optional[int] = None, |
| 1040 | + client: Optional[Redis] = None, |
| 1041 | + ) -> Set[Any]: |
| 1042 | + if client is None: |
| 1043 | + client = self.get_client(write=False) |
| 1044 | + |
| 1045 | + nkeys = [self.make_key(key, version=version) for key in keys] |
| 1046 | + return {self.decode(value) for value in client.sunion(*nkeys)} |
| 1047 | + |
| 1048 | + def sunionstore( |
| 1049 | + self, |
| 1050 | + destination: Any, |
| 1051 | + *keys: KeyT, |
| 1052 | + version: Optional[int] = None, |
| 1053 | + client: Optional[Redis] = None, |
| 1054 | + ) -> int: |
| 1055 | + if client is None: |
| 1056 | + client = self.get_client(write=True) |
| 1057 | + |
| 1058 | + destination = self.make_key(destination, version=version) |
| 1059 | + encoded_keys = [self.make_key(key, version=version) for key in keys] |
| 1060 | + return int(client.sunionstore(destination, *encoded_keys)) |
| 1061 | + |
781 | 1062 | def close(self) -> None:
|
782 | 1063 | close_flag = self._options.get(
|
783 | 1064 | "CLOSE_CONNECTION",
|
|
0 commit comments