blob: 6b4b83021ad96500d9503e1e87f4f9b7fd67deaf (
plain)
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
|
Metadata-Version: 2.1
Name: lazy-object-proxy
Version: 1.4.3
Summary: A fast and thorough lazy object proxy.
Home-page: https://github.com/ionelmc/python-lazy-object-proxy
Author: Ionel Cristian Mărieș
Author-email: contact@ionelmc.ro
License: BSD-2-Clause
Project-URL: Documentation, https://python-lazy-object-proxy.readthedocs.io/
Project-URL: Changelog, https://python-lazy-object-proxy.readthedocs.io/en/latest/changelog.html
Project-URL: Issue Tracker, https://github.com/ionelmc/python-lazy-object-proxy/issues
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Utilities
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
========
Overview
========
A fast and thorough lazy object proxy.
* Free software: BSD 2-Clause License
Note that this is based on `wrapt`_'s ObjectProxy with one big change: it calls a function the first time the proxy object is
used, while `wrapt.ObjectProxy` just forwards the method calls to the target object.
In other words, you use `lazy-object-proxy` when you only have the object way later and you use `wrapt.ObjectProxy` when you
want to override few methods (by subclassing) and forward everything else to the target object.
Example::
import lazy_object_proxy
def expensive_func():
from time import sleep
print('starting calculation')
# just as example for a very slow computation
sleep(2)
print('finished calculation')
# return the result of the calculation
return 10
obj = lazy_object_proxy.Proxy(expensive_func)
# function is called only when object is actually used
print(obj) # now expensive_func is called
print(obj) # the result without calling the expensive_func
Installation
============
::
pip install lazy-object-proxy
Documentation
=============
https://python-lazy-object-proxy.readthedocs.io/
Development
===========
To run the all tests run::
tox
Acknowledgements
================
This project is based on some code from `wrapt`_ as you can see in the git history.
.. _wrapt: https://github.com/GrahamDumpleton/wrapt
Changelog
=========
1.4.3 (2019-10-26)
------------------
* Added binary wheels for Python 3.8.
* Fixed license metadata.
1.4.2 (2019-08-22)
------------------
* Included a ``pyproject.toml`` to allow users install the sdist with old python/setuptools, as the
setuptools-scm dep will be fetched by pip instead of setuptools.
Fixes `#30 <https://github.com/ionelmc/python-lazy-object-proxy/issues/30>`_.
1.4.1 (2019-05-10)
------------------
* Fixed wheels being built with ``-coverage`` cflags. No more issues about bogus ``cext.gcda`` files.
* Removed useless C file from wheels.
* Changed ``setup.py`` to use setuptools-scm.
1.4.0 (2019-05-05)
------------------
* Fixed ``__mod__`` for the slots backend. Contributed by Ran Benita in
`#28 <https://github.com/ionelmc/python-lazy-object-proxy/pull/28>`_.
* Dropped support for Python 2.6 and 3.3. Contributed by "hugovk" in
`#24 <https://github.com/ionelmc/python-lazy-object-proxy/pull/24>`_.
1.3.1 (2017-05-05)
------------------
* Fix broken release (``sdist`` had a broken ``MANIFEST.in``).
1.3.0 (2017-05-02)
------------------
* Speed up arithmetic operations involving ``cext.Proxy`` subclasses.
1.2.2 (2016-04-14)
------------------
* Added `manylinux <https://www.python.org/dev/peps/pep-0513/>`_ wheels.
* Minor cleanup in readme.
1.2.1 (2015-08-18)
------------------
* Fix a memory leak (the wrapped object would get bogus references). Contributed by Astrum Kuo in
`#10 <https://github.com/ionelmc/python-lazy-object-proxy/pull/10>`_.
1.2.0 (2015-07-06)
------------------
* Don't instantiate the object when __repr__ is called. This aids with debugging (allows one to see exactly in
what state the proxy is).
1.1.0 (2015-07-05)
------------------
* Added support for pickling. The pickled value is going to be the wrapped object *without* any Proxy container.
* Fixed a memory management issue in the C extension (reference cycles weren't garbage collected due to improper
handling in the C extension). Contributed by Alvin Chow in
`#8 <https://github.com/ionelmc/python-lazy-object-proxy/pull/8>`_.
1.0.2 (2015-04-11)
-----------------------------------------
* First release on PyPI.
|
