|
1
|
|
|
import operator |
|
2
|
|
|
|
|
3
|
|
|
from .compat import PY2 |
|
4
|
|
|
from .compat import PY3 |
|
5
|
|
|
from .compat import with_metaclass |
|
6
|
|
|
from .utils import identity |
|
7
|
|
|
|
|
8
|
|
|
|
|
9
|
|
|
class _ProxyMethods(object): |
|
10
|
|
|
# We use properties to override the values of __module__ and |
|
11
|
|
|
# __doc__. If we add these in ObjectProxy, the derived class |
|
12
|
|
|
# __dict__ will still be setup to have string variants of these |
|
13
|
|
|
# attributes and the rules of descriptors means that they appear to |
|
14
|
|
|
# take precedence over the properties in the base class. To avoid |
|
15
|
|
|
# that, we copy the properties into the derived class type itself |
|
16
|
|
|
# via a meta class. In that way the properties will always take |
|
17
|
|
|
# precedence. |
|
18
|
|
|
|
|
19
|
|
|
@property |
|
20
|
|
|
def __module__(self): |
|
21
|
|
|
return self.__wrapped__.__module__ |
|
22
|
|
|
|
|
23
|
|
|
@__module__.setter |
|
24
|
|
|
def __module__(self, value): |
|
25
|
|
|
self.__wrapped__.__module__ = value |
|
26
|
|
|
|
|
27
|
|
|
@property |
|
28
|
|
|
def __doc__(self): |
|
29
|
|
|
return self.__wrapped__.__doc__ |
|
30
|
|
|
|
|
31
|
|
|
@__doc__.setter |
|
32
|
|
|
def __doc__(self, value): |
|
33
|
|
|
self.__wrapped__.__doc__ = value |
|
34
|
|
|
|
|
35
|
|
|
# We similar use a property for __dict__. We need __dict__ to be |
|
36
|
|
|
# explicit to ensure that vars() works as expected. |
|
37
|
|
|
|
|
38
|
|
|
@property |
|
39
|
|
|
def __dict__(self): |
|
40
|
|
|
return self.__wrapped__.__dict__ |
|
41
|
|
|
|
|
42
|
|
|
# Need to also propagate the special __weakref__ attribute for case |
|
43
|
|
|
# where decorating classes which will define this. If do not define |
|
44
|
|
|
# it and use a function like inspect.getmembers() on a decorator |
|
45
|
|
|
# class it will fail. This can't be in the derived classes. |
|
46
|
|
|
|
|
47
|
|
|
@property |
|
48
|
|
|
def __weakref__(self): |
|
49
|
|
|
return self.__wrapped__.__weakref__ |
|
50
|
|
|
|
|
51
|
|
|
|
|
52
|
|
|
class _ProxyMetaType(type): |
|
53
|
|
|
def __new__(cls, name, bases, dictionary): |
|
54
|
|
|
# Copy our special properties into the class so that they |
|
55
|
|
|
# always take precedence over attributes of the same name added |
|
56
|
|
|
# during construction of a derived class. This is to save |
|
57
|
|
|
# duplicating the implementation for them in all derived classes. |
|
58
|
|
|
|
|
59
|
|
|
dictionary.update(vars(_ProxyMethods)) |
|
60
|
|
|
|
|
61
|
|
|
return type.__new__(cls, name, bases, dictionary) |
|
62
|
|
|
|
|
63
|
|
|
|
|
64
|
|
|
class Proxy(with_metaclass(_ProxyMetaType)): |
|
65
|
|
|
""" |
|
66
|
|
|
A proxy implementation in pure Python, using slots. You can subclass this to add |
|
67
|
|
|
local methods or attributes, or enable __dict__. |
|
68
|
|
|
|
|
69
|
|
|
The most important internals: |
|
70
|
|
|
|
|
71
|
|
|
* ``__factory__`` is the callback that "materializes" the object we proxy to. |
|
72
|
|
|
* ``__target__`` will contain the object we proxy to, once it's "materialized". |
|
73
|
|
|
* ``__wrapped__`` is a property that does either: |
|
74
|
|
|
|
|
75
|
|
|
* return ``__target__`` if it's set. |
|
76
|
|
|
* calls ``__factory__``, saves result to ``__target__`` and returns said result. |
|
77
|
|
|
""" |
|
78
|
|
|
|
|
79
|
|
|
__slots__ = '__target__', '__factory__' |
|
80
|
|
|
|
|
81
|
|
|
def __init__(self, factory): |
|
82
|
|
|
object.__setattr__(self, '__factory__', factory) |
|
83
|
|
|
|
|
84
|
|
|
@property |
|
85
|
|
|
def __wrapped__(self, __getattr__=object.__getattribute__, __setattr__=object.__setattr__, |
|
86
|
|
|
__delattr__=object.__delattr__): |
|
87
|
|
|
try: |
|
88
|
|
|
return __getattr__(self, '__target__') |
|
89
|
|
|
except AttributeError: |
|
90
|
|
|
try: |
|
91
|
|
|
factory = __getattr__(self, '__factory__') |
|
92
|
|
|
except AttributeError: |
|
93
|
|
|
raise ValueError("Proxy hasn't been initiated: __factory__ is missing.") |
|
94
|
|
|
target = factory() |
|
95
|
|
|
__setattr__(self, '__target__', target) |
|
96
|
|
|
return target |
|
97
|
|
|
|
|
98
|
|
|
@__wrapped__.deleter |
|
99
|
|
|
def __wrapped__(self, __delattr__=object.__delattr__): |
|
100
|
|
|
__delattr__(self, '__target__') |
|
101
|
|
|
|
|
102
|
|
|
@__wrapped__.setter |
|
103
|
|
|
def __wrapped__(self, target, __setattr__=object.__setattr__): |
|
104
|
|
|
__setattr__(self, '__target__', target) |
|
105
|
|
|
|
|
106
|
|
|
@property |
|
107
|
|
|
def __name__(self): |
|
108
|
|
|
return self.__wrapped__.__name__ |
|
109
|
|
|
|
|
110
|
|
|
@__name__.setter |
|
111
|
|
|
def __name__(self, value): |
|
112
|
|
|
self.__wrapped__.__name__ = value |
|
113
|
|
|
|
|
114
|
|
|
@property |
|
115
|
|
|
def __class__(self): |
|
116
|
|
|
return self.__wrapped__.__class__ |
|
117
|
|
|
|
|
118
|
|
|
@__class__.setter |
|
119
|
|
|
def __class__(self, value): |
|
120
|
|
|
self.__wrapped__.__class__ = value |
|
121
|
|
|
|
|
122
|
|
|
@property |
|
123
|
|
|
def __annotations__(self): |
|
124
|
|
|
return self.__wrapped__.__anotations__ |
|
125
|
|
|
|
|
126
|
|
|
@__annotations__.setter |
|
127
|
|
|
def __annotations__(self, value): |
|
128
|
|
|
self.__wrapped__.__annotations__ = value |
|
129
|
|
|
|
|
130
|
|
|
def __dir__(self): |
|
131
|
|
|
return dir(self.__wrapped__) |
|
132
|
|
|
|
|
133
|
|
|
def __str__(self): |
|
134
|
|
|
return str(self.__wrapped__) |
|
135
|
|
|
|
|
136
|
|
|
if PY3: |
|
137
|
|
|
def __bytes__(self): |
|
138
|
|
|
return bytes(self.__wrapped__) |
|
139
|
|
|
|
|
140
|
|
|
def __repr__(self, __getattr__=object.__getattribute__): |
|
141
|
|
|
try: |
|
142
|
|
|
target = __getattr__(self, '__target__') |
|
143
|
|
|
except AttributeError: |
|
144
|
|
|
return '<%s at 0x%x with factory %r>' % ( |
|
145
|
|
|
type(self).__name__, id(self), |
|
146
|
|
|
self.__factory__ |
|
147
|
|
|
) |
|
148
|
|
|
else: |
|
149
|
|
|
return '<%s at 0x%x wrapping %r at 0x%x with factory %r>' % ( |
|
150
|
|
|
type(self).__name__, id(self), |
|
151
|
|
|
target, id(target), |
|
152
|
|
|
self.__factory__ |
|
153
|
|
|
) |
|
154
|
|
|
|
|
155
|
|
|
def __reversed__(self): |
|
156
|
|
|
return reversed(self.__wrapped__) |
|
157
|
|
|
|
|
158
|
|
|
if PY3: |
|
159
|
|
|
def __round__(self): |
|
160
|
|
|
return round(self.__wrapped__) |
|
161
|
|
|
|
|
162
|
|
|
def __lt__(self, other): |
|
163
|
|
|
return self.__wrapped__ < other |
|
164
|
|
|
|
|
165
|
|
|
def __le__(self, other): |
|
166
|
|
|
return self.__wrapped__ <= other |
|
167
|
|
|
|
|
168
|
|
|
def __eq__(self, other): |
|
169
|
|
|
return self.__wrapped__ == other |
|
170
|
|
|
|
|
171
|
|
|
def __ne__(self, other): |
|
172
|
|
|
return self.__wrapped__ != other |
|
173
|
|
|
|
|
174
|
|
|
def __gt__(self, other): |
|
175
|
|
|
return self.__wrapped__ > other |
|
176
|
|
|
|
|
177
|
|
|
def __ge__(self, other): |
|
178
|
|
|
return self.__wrapped__ >= other |
|
179
|
|
|
|
|
180
|
|
|
def __hash__(self): |
|
181
|
|
|
return hash(self.__wrapped__) |
|
182
|
|
|
|
|
183
|
|
|
def __nonzero__(self): |
|
184
|
|
|
return bool(self.__wrapped__) |
|
185
|
|
|
|
|
186
|
|
|
def __bool__(self): |
|
187
|
|
|
return bool(self.__wrapped__) |
|
188
|
|
|
|
|
189
|
|
|
def __setattr__(self, name, value, __setattr__=object.__setattr__): |
|
190
|
|
|
if hasattr(type(self), name): |
|
191
|
|
|
__setattr__(self, name, value) |
|
192
|
|
|
else: |
|
193
|
|
|
setattr(self.__wrapped__, name, value) |
|
194
|
|
|
|
|
195
|
|
|
def __getattr__(self, name): |
|
196
|
|
|
if name in ('__wrapped__', '__factory__'): |
|
197
|
|
|
raise AttributeError(name) |
|
198
|
|
|
else: |
|
199
|
|
|
return getattr(self.__wrapped__, name) |
|
200
|
|
|
|
|
201
|
|
|
def __delattr__(self, name, __delattr__=object.__delattr__): |
|
202
|
|
|
if hasattr(type(self), name): |
|
203
|
|
|
__delattr__(self, name) |
|
204
|
|
|
else: |
|
205
|
|
|
delattr(self.__wrapped__, name) |
|
206
|
|
|
|
|
207
|
|
|
def __add__(self, other): |
|
208
|
|
|
return self.__wrapped__ + other |
|
209
|
|
|
|
|
210
|
|
|
def __sub__(self, other): |
|
211
|
|
|
return self.__wrapped__ - other |
|
212
|
|
|
|
|
213
|
|
|
def __mul__(self, other): |
|
214
|
|
|
return self.__wrapped__ * other |
|
215
|
|
|
|
|
216
|
|
|
def __div__(self, other): |
|
217
|
|
|
return operator.div(self.__wrapped__, other) |
|
218
|
|
|
|
|
219
|
|
|
def __truediv__(self, other): |
|
220
|
|
|
return operator.truediv(self.__wrapped__, other) |
|
221
|
|
|
|
|
222
|
|
|
def __floordiv__(self, other): |
|
223
|
|
|
return self.__wrapped__ // other |
|
224
|
|
|
|
|
225
|
|
|
def __mod__(self, other): |
|
226
|
|
|
return self.__wrapped__ ^ other |
|
227
|
|
|
|
|
228
|
|
|
def __divmod__(self, other): |
|
229
|
|
|
return divmod(self.__wrapped__, other) |
|
230
|
|
|
|
|
231
|
|
|
def __pow__(self, other, *args): |
|
232
|
|
|
return pow(self.__wrapped__, other, *args) |
|
233
|
|
|
|
|
234
|
|
|
def __lshift__(self, other): |
|
235
|
|
|
return self.__wrapped__ << other |
|
236
|
|
|
|
|
237
|
|
|
def __rshift__(self, other): |
|
238
|
|
|
return self.__wrapped__ >> other |
|
239
|
|
|
|
|
240
|
|
|
def __and__(self, other): |
|
241
|
|
|
return self.__wrapped__ & other |
|
242
|
|
|
|
|
243
|
|
|
def __xor__(self, other): |
|
244
|
|
|
return self.__wrapped__ ^ other |
|
245
|
|
|
|
|
246
|
|
|
def __or__(self, other): |
|
247
|
|
|
return self.__wrapped__ | other |
|
248
|
|
|
|
|
249
|
|
|
def __radd__(self, other): |
|
250
|
|
|
return other + self.__wrapped__ |
|
251
|
|
|
|
|
252
|
|
|
def __rsub__(self, other): |
|
253
|
|
|
return other - self.__wrapped__ |
|
254
|
|
|
|
|
255
|
|
|
def __rmul__(self, other): |
|
256
|
|
|
return other * self.__wrapped__ |
|
257
|
|
|
|
|
258
|
|
|
def __rdiv__(self, other): |
|
259
|
|
|
return operator.div(other, self.__wrapped__) |
|
260
|
|
|
|
|
261
|
|
|
def __rtruediv__(self, other): |
|
262
|
|
|
return operator.truediv(other, self.__wrapped__) |
|
263
|
|
|
|
|
264
|
|
|
def __rfloordiv__(self, other): |
|
265
|
|
|
return other // self.__wrapped__ |
|
266
|
|
|
|
|
267
|
|
|
def __rmod__(self, other): |
|
268
|
|
|
return other % self.__wrapped__ |
|
269
|
|
|
|
|
270
|
|
|
def __rdivmod__(self, other): |
|
271
|
|
|
return divmod(other, self.__wrapped__) |
|
272
|
|
|
|
|
273
|
|
|
def __rpow__(self, other, *args): |
|
274
|
|
|
return pow(other, self.__wrapped__, *args) |
|
275
|
|
|
|
|
276
|
|
|
def __rlshift__(self, other): |
|
277
|
|
|
return other << self.__wrapped__ |
|
278
|
|
|
|
|
279
|
|
|
def __rrshift__(self, other): |
|
280
|
|
|
return other >> self.__wrapped__ |
|
281
|
|
|
|
|
282
|
|
|
def __rand__(self, other): |
|
283
|
|
|
return other & self.__wrapped__ |
|
284
|
|
|
|
|
285
|
|
|
def __rxor__(self, other): |
|
286
|
|
|
return other ^ self.__wrapped__ |
|
287
|
|
|
|
|
288
|
|
|
def __ror__(self, other): |
|
289
|
|
|
return other | self.__wrapped__ |
|
290
|
|
|
|
|
291
|
|
|
def __iadd__(self, other): |
|
292
|
|
|
self.__wrapped__ += other |
|
293
|
|
|
return self |
|
294
|
|
|
|
|
295
|
|
|
def __isub__(self, other): |
|
296
|
|
|
self.__wrapped__ -= other |
|
297
|
|
|
return self |
|
298
|
|
|
|
|
299
|
|
|
def __imul__(self, other): |
|
300
|
|
|
self.__wrapped__ *= other |
|
301
|
|
|
return self |
|
302
|
|
|
|
|
303
|
|
|
def __idiv__(self, other): |
|
304
|
|
|
self.__wrapped__ = operator.idiv(self.__wrapped__, other) |
|
305
|
|
|
return self |
|
306
|
|
|
|
|
307
|
|
|
def __itruediv__(self, other): |
|
308
|
|
|
self.__wrapped__ = operator.itruediv(self.__wrapped__, other) |
|
309
|
|
|
return self |
|
310
|
|
|
|
|
311
|
|
|
def __ifloordiv__(self, other): |
|
312
|
|
|
self.__wrapped__ //= other |
|
313
|
|
|
return self |
|
314
|
|
|
|
|
315
|
|
|
def __imod__(self, other): |
|
316
|
|
|
self.__wrapped__ %= other |
|
317
|
|
|
return self |
|
318
|
|
|
|
|
319
|
|
|
def __ipow__(self, other): |
|
320
|
|
|
self.__wrapped__ **= other |
|
321
|
|
|
return self |
|
322
|
|
|
|
|
323
|
|
|
def __ilshift__(self, other): |
|
324
|
|
|
self.__wrapped__ <<= other |
|
325
|
|
|
return self |
|
326
|
|
|
|
|
327
|
|
|
def __irshift__(self, other): |
|
328
|
|
|
self.__wrapped__ >>= other |
|
329
|
|
|
return self |
|
330
|
|
|
|
|
331
|
|
|
def __iand__(self, other): |
|
332
|
|
|
self.__wrapped__ &= other |
|
333
|
|
|
return self |
|
334
|
|
|
|
|
335
|
|
|
def __ixor__(self, other): |
|
336
|
|
|
self.__wrapped__ ^= other |
|
337
|
|
|
return self |
|
338
|
|
|
|
|
339
|
|
|
def __ior__(self, other): |
|
340
|
|
|
self.__wrapped__ |= other |
|
341
|
|
|
return self |
|
342
|
|
|
|
|
343
|
|
|
def __neg__(self): |
|
344
|
|
|
return -self.__wrapped__ |
|
345
|
|
|
|
|
346
|
|
|
def __pos__(self): |
|
347
|
|
|
return +self.__wrapped__ |
|
348
|
|
|
|
|
349
|
|
|
def __abs__(self): |
|
350
|
|
|
return abs(self.__wrapped__) |
|
351
|
|
|
|
|
352
|
|
|
def __invert__(self): |
|
353
|
|
|
return ~self.__wrapped__ |
|
354
|
|
|
|
|
355
|
|
|
def __int__(self): |
|
356
|
|
|
return int(self.__wrapped__) |
|
357
|
|
|
|
|
358
|
|
|
if PY2: |
|
359
|
|
|
def __long__(self): |
|
360
|
|
|
return long(self.__wrapped__) # flake8: noqa |
|
361
|
|
|
|
|
362
|
|
|
def __float__(self): |
|
363
|
|
|
return float(self.__wrapped__) |
|
364
|
|
|
|
|
365
|
|
|
def __oct__(self): |
|
366
|
|
|
return oct(self.__wrapped__) |
|
367
|
|
|
|
|
368
|
|
|
def __hex__(self): |
|
369
|
|
|
return hex(self.__wrapped__) |
|
370
|
|
|
|
|
371
|
|
|
def __index__(self): |
|
372
|
|
|
return operator.index(self.__wrapped__) |
|
373
|
|
|
|
|
374
|
|
|
def __len__(self): |
|
375
|
|
|
return len(self.__wrapped__) |
|
376
|
|
|
|
|
377
|
|
|
def __contains__(self, value): |
|
378
|
|
|
return value in self.__wrapped__ |
|
379
|
|
|
|
|
380
|
|
|
def __getitem__(self, key): |
|
381
|
|
|
return self.__wrapped__[key] |
|
382
|
|
|
|
|
383
|
|
|
def __setitem__(self, key, value): |
|
384
|
|
|
self.__wrapped__[key] = value |
|
385
|
|
|
|
|
386
|
|
|
def __delitem__(self, key): |
|
387
|
|
|
del self.__wrapped__[key] |
|
388
|
|
|
|
|
389
|
|
|
def __getslice__(self, i, j): |
|
390
|
|
|
return self.__wrapped__[i:j] |
|
391
|
|
|
|
|
392
|
|
|
def __setslice__(self, i, j, value): |
|
393
|
|
|
self.__wrapped__[i:j] = value |
|
394
|
|
|
|
|
395
|
|
|
def __delslice__(self, i, j): |
|
396
|
|
|
del self.__wrapped__[i:j] |
|
397
|
|
|
|
|
398
|
|
|
def __enter__(self): |
|
399
|
|
|
return self.__wrapped__.__enter__() |
|
400
|
|
|
|
|
401
|
|
|
def __exit__(self, *args, **kwargs): |
|
402
|
|
|
return self.__wrapped__.__exit__(*args, **kwargs) |
|
403
|
|
|
|
|
404
|
|
|
def __iter__(self): |
|
405
|
|
|
return iter(self.__wrapped__) |
|
406
|
|
|
|
|
407
|
|
|
def __call__(self, *args, **kwargs): |
|
408
|
|
|
return self.__wrapped__(*args, **kwargs) |
|
409
|
|
|
|
|
410
|
|
|
def __reduce__(self): |
|
411
|
|
|
return identity, (self.__wrapped__,) |
|
412
|
|
|
|
|
413
|
|
|
def __reduce_ex__(self, protocol): |
|
414
|
|
|
return identity, (self.__wrapped__,) |
|
415
|
|
|
|