From 631043f4b2fcb6021bc3dff016270a3999df699f Mon Sep 17 00:00:00 2001 From: Zac Medico Date: Sat, 30 Oct 2010 23:32:42 -0700 Subject: Update docstring for LazyItemsDict.__deepcopy__() --- pym/portage/util/__init__.py | 21 ++++----------------- 1 file changed, 4 insertions(+), 17 deletions(-) diff --git a/pym/portage/util/__init__.py b/pym/portage/util/__init__.py index a0f578eb4..51c35d385 100644 --- a/pym/portage/util/__init__.py +++ b/pym/portage/util/__init__.py @@ -1315,23 +1315,10 @@ class LazyItemsDict(UserDict): def __deepcopy__(self, memo=None): """ - WARNING: If any of the lazy items contains a bound method then it's - typical for deepcopy() to raise an exception like this: - - File "/usr/lib/python2.5/copy.py", line 189, in deepcopy - y = _reconstruct(x, rv, 1, memo) - File "/usr/lib/python2.5/copy.py", line 322, in _reconstruct - y = callable(*args) - File "/usr/lib/python2.5/copy_reg.py", line 92, in __newobj__ - return cls.__new__(cls, *args) - TypeError: instancemethod expected at least 2 arguments, got 0 - - If deepcopy() needs to work, this problem can be avoided by - implementing lazy items with normal (non-bound) functions. - - If deepcopy() raises a TypeError for a lazy item that has been added - via a call to addLazySingleton(), the singleton will be automatically - evaluated and deepcopy() will instead be called on the result. + This forces evaluation of each contained lazy item, and deepcopy of + the result. A TypeError is raised if any contained lazy item is not + a singleton, since it is not necessarily possible for the behavior + of this type of item to be safely preserved. """ if memo is None: memo = {} -- cgit v1.2.3-1-g7c22