Module faults
Handle uncaught ObjC/NSExceptions and other
faults similar to standard module faulthandler
available since Python 3.3.
By default, fault handling is not enabled. In Python 3.3
and later, the faulthandler may be enabled by (a) calling function
faulthandler.enable or (b) setting env variable PYTHONFAULTHANDLER to any non-empty string or (c)
including option -X faulthandler on the python command
line.
Command line option -X faulthandler is not available in
older Python releases, but fault handling by this
module pycocoa.faults can be enabled by either (a) calling
function faults.enable or (b) setting env variable PYTHONFAULTHANDLER to any non-empty string.
If env variable PYTHONFAULTHANDLER=pycocoa (in
Python 3.3 or later), the Python faulthandler will be
overridden by this module pycocoa.faults.
See function segfaulty for details about SEGFAULTs,
indefinite hangs and env variable
PYCOCOA_SEGFAULTY.
|
|
segfaulty()
Return True if SegfaultErrors are raised to prevent certain
SEGFAULTs, False if SEGFAULTs are not expected or
None if unknown. |
|
|
|
|
|
|
|
enable(file=sys.stderr,
**unused)
Enable fault handling similar to the faulthandler module available in Python 3.3 and
later. |
|
|
|
|
is_enabled(sig=None)
Check whether fault handling is enabled, similar to the
faulthandler module available in Python 3.3 and
later. |
|
|
|
|
SIGs_enabled(*sigs)
Return the signals currently handled as fault. |
|
|
|
|
exiting(status=None)
Get/set the exit and status to use after
faults or uncaught
ObjC/NSExceptions. |
|
|
|
|
|
|
|
|
|
|
__all__ = _ALL_LAZY.faults
|
|
|
args = sys.argv [1:]
|
|
|
r = NSColor.redColor()
|
|
|
c = r.cyanComponent()
|
|
Return True if SegfaultErrors are raised to prevent certain
SEGFAULTs, False if SEGFAULTs are not expected or
None if unknown.
Note:
Functions pycocoa.get_classes2,
pycocoa.get_classname,
pycocoa.get_classnameof,
pycocoa.get_classof, etc. may SEGFAULT or hang
infinitely since macOS 15.0 Sequoia on Intel
(x86_64) and Intel emulation
("arm64_x86_64". By default
pycocoa raises a SegfaultError in that
case unless fault handling is enabled, see module pycocoa.faults.
Set env variable PYCOCOA_SEGFAULTY to any non-empty
string to suppress SegfaultError exceptions and to
risk SEGFAULTs and hangs.
|
|
Disable fault handling and uninstall the signal handlers
installed by faults.enable, like the faulthandler module in Python 3.3 and later.
- Returns:
None.
|
enable(file=sys.stderr,
**unused)
|
|
Enable fault handling similar to the faulthandler module available in Python 3.3 and
later.
Try to install handlers for the SIGABRT,
SIGBUS, SIGFPE, SIGILL and
SIGSEGV signals to dump a an ObjC call stack and Python
traceback to file.
- Raises:
TypeError - File file doesn't have callable
write and flush attributes.
|
|
Check whether fault handling is enabled, similar to the
faulthandler module available in Python 3.3 and
later.
- Parameters:
sig - Check whether fault handling includes this signal
(signal.SIG*). - Returns:
True if fault handling is currently
enabled, False otherwise.
|
|
Return the signals currently handled as fault.
- Returns:
- An Adict with the
SIG* name and value
of the currently handled signals, if any.
|
|
Get/set the exit and status to use after
faults or uncaught
ObjC/NSExceptions.
- Parameters:
status - The exit "door" and status code to be used (small
int) or None to leave unchanged. A
negative status invokes
os._exit(abs(status)) to terminate without normal
exit processing, while a non-negative
status uses sys.exit(status)
after a fault. - Returns:
- The previously set
exiting code
(int).
Note:
The faulthandler module in Python 3.3 and later
ignores all exiting settings.
|
getUncaughtExceptionHandler()
|
|
Get the currently installed uncaught
ObjC/NSException handler.
- Returns:
- The installed handler (
callable) or
None if no handler was or couldn't be installed
(like on macOS 12.0.1 Monterey, for example).
|
setUncaughtExceptionHandler(handler,
log=True,
raiser=False)
|
|
Install a callback to handle uncaught
ObjC/NSExceptions.
The handler(error) is called with one argument
error, an NSExceptionError instance. It should return that same
error, an exiting status or None. If an
error, that error will subsequently be raised
as Python exception.
- Parameters:
handler - A callable to be invoked with a single argument
error, an NSExceptionError instance and to return that
same error, an exiting status or
None.log - Print the error, an time stamp and -if avilable- the
ObjC callstack and Python traceback prior to invoking the
handler (bool).raiser - Raise the NSExceptionError error,
regardless of the return value from the
handler. - Returns:
- The previously installed uncaught
ObjC/NSException handler or None if no
handler was or couldn't be installed.
- Raises:
RuntimeError - Setting uncaught exception handlers unavailable, but only thrown if
raiser=True.TypeError - The handler is not callable.
|