aboutsummaryrefslogtreecommitdiffstats
path: root/python/gevent/exceptions.py
diff options
context:
space:
mode:
authorJames Taylor <user234683@users.noreply.github.com>2018-09-14 19:32:27 -0700
committerJames Taylor <user234683@users.noreply.github.com>2018-09-14 19:32:27 -0700
commit4212164e91ba2f49583cf44ad623a29b36db8f77 (patch)
tree47aefe3c0162f03e0c823b43873356f69c1cd636 /python/gevent/exceptions.py
parent6ca20ff7010f2bafc7fefcb8cad982be27a8aeae (diff)
downloadyt-local-4212164e91ba2f49583cf44ad623a29b36db8f77.tar.lz
yt-local-4212164e91ba2f49583cf44ad623a29b36db8f77.tar.xz
yt-local-4212164e91ba2f49583cf44ad623a29b36db8f77.zip
Windows: Use 32-bit distribution of python
Diffstat (limited to 'python/gevent/exceptions.py')
-rw-r--r--python/gevent/exceptions.py79
1 files changed, 79 insertions, 0 deletions
diff --git a/python/gevent/exceptions.py b/python/gevent/exceptions.py
new file mode 100644
index 0000000..2c779ce
--- /dev/null
+++ b/python/gevent/exceptions.py
@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*-
+# copyright 2018 gevent
+"""
+Exceptions.
+
+.. versionadded:: 1.3b1
+
+"""
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+
+
+__all__ = [
+ 'LoopExit',
+]
+
+
+class LoopExit(Exception):
+ """
+ Exception thrown when the hub finishes running (`gevent.hub.Hub.run`
+ would return).
+
+ In a normal application, this is never thrown or caught
+ explicitly. The internal implementation of functions like
+ :meth:`gevent.hub.Hub.join` and :func:`gevent.joinall` may catch it, but user code
+ generally should not.
+
+ .. caution::
+ Errors in application programming can also lead to this exception being
+ raised. Some examples include (but are not limited too):
+
+ - greenlets deadlocking on a lock;
+ - using a socket or other gevent object with native thread
+ affinity from a different thread
+
+ """
+
+ def __repr__(self):
+ # pylint:disable=unsubscriptable-object
+ if len(self.args) == 3: # From the hub
+ import pprint
+ return "%s\n\tHub: %s\n\tHandles:\n%s" % (
+ self.args[0], self.args[1],
+ pprint.pformat(self.args[2])
+ )
+ return Exception.__repr__(self)
+
+ def __str__(self):
+ return repr(self)
+
+class BlockingSwitchOutError(AssertionError):
+ """
+ Raised when a gevent synchronous function is called from a
+ low-level event loop callback.
+
+ This is usually a programming error.
+ """
+
+
+class InvalidSwitchError(AssertionError):
+ """
+ Raised when the event loop returns control to a greenlet in an
+ unexpected way.
+
+ This is usually a bug in gevent, greenlet, or the event loop.
+ """
+
+class ConcurrentObjectUseError(AssertionError):
+ """
+ Raised when an object is used (waited on) by two greenlets
+ independently, meaning the object was entered into a blocking
+ state by one greenlet and then another while still blocking in the
+ first one.
+
+ This is usually a programming error.
+
+ .. seealso:: `gevent.socket.wait`
+ """