1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
# Copyright 2012 Pinterest.com
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
from functools import partial
import logging
from io import BytesIO
import pickle
import zlib
FLAG_BYTES = 0
FLAG_PICKLE = 1 << 0
FLAG_INTEGER = 1 << 1
FLAG_LONG = 1 << 2
FLAG_COMPRESSED = 1 << 3
FLAG_TEXT = 1 << 4
# Pickle protocol version (highest available to runtime)
# Warning with `0`: If somewhere in your value lies a slotted object,
# ie defines `__slots__`, even if you do not include it in your pickleable
# state via `__getstate__`, python will complain with something like:
# TypeError: a class that defines __slots__ without defining __getstate__
# cannot be pickled
DEFAULT_PICKLE_VERSION = pickle.HIGHEST_PROTOCOL
def _python_memcache_serializer(key, value, pickle_version=None):
flags = 0
value_type = type(value)
# Check against exact types so that subclasses of native types will be
# restored as their native type
if value_type is bytes:
pass
elif value_type is str:
flags |= FLAG_TEXT
value = value.encode("utf8")
elif value_type is int:
flags |= FLAG_INTEGER
value = "%d" % value
else:
flags |= FLAG_PICKLE
output = BytesIO()
pickler = pickle.Pickler(output, pickle_version)
pickler.dump(value)
value = output.getvalue()
return value, flags
def get_python_memcache_serializer(pickle_version=DEFAULT_PICKLE_VERSION):
"""Return a serializer using a specific pickle version"""
return partial(_python_memcache_serializer, pickle_version=pickle_version)
python_memcache_serializer = get_python_memcache_serializer()
def python_memcache_deserializer(key, value, flags):
if flags == 0:
return value
elif flags & FLAG_TEXT:
return value.decode("utf8")
elif flags & FLAG_INTEGER:
return int(value)
elif flags & FLAG_LONG:
return int(value)
elif flags & FLAG_PICKLE:
try:
buf = BytesIO(value)
unpickler = pickle.Unpickler(buf)
return unpickler.load()
except Exception:
logging.info("Pickle error", exc_info=True)
return None
return value
class PickleSerde:
"""
An object which implements the serialization/deserialization protocol for
:py:class:`pymemcache.client.base.Client` and its descendants using the
:mod:`pickle` module.
Serialization and deserialization are implemented as methods of this class.
To implement a custom serialization/deserialization method for pymemcache,
you should implement the same interface as the one provided by this object
-- :py:meth:`pymemcache.serde.PickleSerde.serialize` and
:py:meth:`pymemcache.serde.PickleSerde.deserialize`. Then,
pass your custom object to the pymemcache client object in place of
`PickleSerde`.
For more details on the serialization protocol, see the class documentation
for :py:class:`pymemcache.client.base.Client`
"""
def __init__(self, pickle_version=DEFAULT_PICKLE_VERSION):
self._serialize_func = get_python_memcache_serializer(pickle_version)
def serialize(self, key, value):
return self._serialize_func(key, value)
def deserialize(self, key, value, flags):
return python_memcache_deserializer(key, value, flags)
pickle_serde = PickleSerde()
class CompressedSerde:
"""
An object which implements the serialization/deserialization protocol for
:py:class:`pymemcache.client.base.Client` and its descendants with
configurable compression.
"""
def __init__(
self,
compress=zlib.compress,
decompress=zlib.decompress,
serde=pickle_serde,
# Discovered scientifically by testing at what point the serialization
# begins to improve, with a little padded on since compression adds
# CPU overhead
# >>> foo = 'foo'*4
# >>> len(zlib.compress(foo.encode('utf-8'))), len(foo)
# (13, 12)
# >>> foo = 'foo'*5
# >>> len(zlib.compress(foo.encode('utf-8'))), len(foo)
# (13, 15)
min_compress_len=30,
):
self._serde = serde
self._compress = compress
self._decompress = decompress
self._min_compress_len = min_compress_len
def serialize(self, key, value):
value, flags = self._serde.serialize(key, value)
if len(value) > self._min_compress_len > 0:
old_value = value
value = self._compress(value)
# Don't use the compressed value if our end result is actually
# larger uncompressed.
if len(old_value) < len(value):
value = old_value
else:
flags |= FLAG_COMPRESSED
return value, flags
def deserialize(self, key, value, flags):
if flags & FLAG_COMPRESSED:
value = self._decompress(value)
value = self._serde.deserialize(key, value, flags)
return value
compressed_serde = CompressedSerde()
class LegacyWrappingSerde:
"""
This class defines how to wrap legacy de/serialization functions into a
'serde' object which implements '.serialize' and '.deserialize' methods.
It is used automatically by pymemcache.client.base.Client when the
'serializer' or 'deserializer' arguments are given.
The serializer_func and deserializer_func are expected to be None in the
case that they are missing.
"""
def __init__(self, serializer_func, deserializer_func):
self.serialize = serializer_func or self._default_serialize
self.deserialize = deserializer_func or self._default_deserialize
def _default_serialize(self, key, value):
return value, 0
def _default_deserialize(self, key, value, flags):
return value
|