diff options
author | phillip.eby <phillip.eby@6015fed2-1504-0410-9fe1-9d1591cc4771> | 2006-02-12 19:20:29 +0000 |
---|---|---|
committer | phillip.eby <phillip.eby@6015fed2-1504-0410-9fe1-9d1591cc4771> | 2006-02-12 19:20:29 +0000 |
commit | 7e48adabf3afe1a472b0070f83d6ecce846b34ab (patch) | |
tree | 99c2c3513ec49c023b12b78f5f7ec5140d3987cb /pkg_resources.txt | |
parent | 5ec14428d52c6f9414788769e47cd583f226f1c4 (diff) | |
download | python-setuptools-7e48adabf3afe1a472b0070f83d6ecce846b34ab.tar.gz |
Misc. doc additions: callback exception handling, and an assortment of
tips and techniques for using easy_install.
git-svn-id: http://svn.python.org/projects/sandbox/trunk/setuptools@42336 6015fed2-1504-0410-9fe1-9d1591cc4771
Diffstat (limited to 'pkg_resources.txt')
-rwxr-xr-x | pkg_resources.txt | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/pkg_resources.txt b/pkg_resources.txt index 6fd1af8..ada2de3 100755 --- a/pkg_resources.txt +++ b/pkg_resources.txt @@ -349,6 +349,13 @@ function are for. yourself to deal with the existing items; just register the callback and be prepared for the fact that it will be called immediately by this method. + Note that callbacks *must not* allow exceptions to propagate, or they will + interfere with the operation of other callbacks and possibly result in an + inconsistent working set state. Callbacks should use a try/except block + to ignore, log, or otherwise process any errors, especially since the code + that caused the callback to be invoked is unlikely to be able to handle + the errors any better than the callback itself. + ``pkg_resources.add_activation_listener()`` is an alternate spelling of ``pkg_resources.working_set.subscribe()``. |