pyobjc-framework-ExceptionHandling 10.3.2__py3-none-any.whl

ExceptionHandling/__init__.py

@@ -0,0 +1,34 @@
+"""
+Python mapping for the ExceptionHandling framework.
+
+This module does not contain docstrings for the wrapped code, check Apple's
+documentation for details on how to use these functions and classes.
+"""
+
+
+def _setup():
+    import sys
+
+    import Foundation
+    import objc
+    from . import _metadata
+
+    dir_func, getattr_func = objc.createFrameworkDirAndGetattr(
+        name="ExceptionHandling",
+        frameworkIdentifier="com.apple.ExceptionHandling",
+        frameworkPath=objc.pathForFramework(
+            "/System/Library/Frameworks/ExceptionHandling.framework"
+        ),
+        globals_dict=globals(),
+        inline_list=None,
+        parents=(Foundation,),
+        metadict=_metadata.__dict__,
+    )
+
+    globals()["__dir__"] = dir_func
+    globals()["__getattr__"] = getattr_func
+
+    del sys.modules["ExceptionHandling._metadata"]
+
+
+globals().pop("_setup")()

ExceptionHandling/_metadata.py

@@ -0,0 +1,84 @@
+# This file is generated by objective.metadata
+#
+# Last update: Sat May 18 09:28:47 2024
+#
+# flake8: noqa
+
+import objc, sys
+from typing import NewType
+
+if sys.maxsize > 2**32:
+
+    def sel32or64(a, b):
+        return b
+
+else:
+
+    def sel32or64(a, b):
+        return a
+
+
+if objc.arch == "arm64":
+
+    def selAorI(a, b):
+        return a
+
+else:
+
+    def selAorI(a, b):
+        return b
+
+
+misc = {}
+constants = """$NSStackTraceKey$NSUncaughtRuntimeErrorException$NSUncaughtSystemExceptionException$"""
+enums = """$NSHandleOtherExceptionMask@512$NSHandleTopLevelExceptionMask@128$NSHandleUncaughtExceptionMask@2$NSHandleUncaughtRuntimeErrorMask@32$NSHandleUncaughtSystemExceptionMask@8$NSHangOnOtherExceptionMask@16$NSHangOnTopLevelExceptionMask@8$NSHangOnUncaughtExceptionMask@1$NSHangOnUncaughtRuntimeErrorMask@4$NSHangOnUncaughtSystemExceptionMask@2$NSLogOtherExceptionMask@256$NSLogTopLevelExceptionMask@64$NSLogUncaughtExceptionMask@1$NSLogUncaughtRuntimeErrorMask@16$NSLogUncaughtSystemExceptionMask@4$"""
+misc.update({})
+misc.update({})
+misc.update({})
+functions = {"NSExceptionHandlerResume": (b"v",)}
+r = objc.registerMetaDataForSelector
+objc._updatingMetadata(True)
+try:
+    r(
+        b"NSObject",
+        b"exceptionHandler:shouldHandleException:mask:",
+        {
+            "retval": {"type": "Z"},
+            "arguments": {2: {"type": b"@"}, 3: {"type": b"@"}, 4: {"type": b"Q"}},
+        },
+    )
+    r(
+        b"NSObject",
+        b"exceptionHandler:shouldLogException:mask:",
+        {
+            "retval": {"type": "Z"},
+            "arguments": {2: {"type": b"@"}, 3: {"type": b"@"}, 4: {"type": b"Q"}},
+        },
+    )
+finally:
+    objc._updatingMetadata(False)
+protocols = {
+    "NSExceptionHandlerDelegate": objc.informal_protocol(
+        "NSExceptionHandlerDelegate",
+        [
+            objc.selector(
+                None,
+                b"exceptionHandler:shouldLogException:mask:",
+                b"Z@:@@Q",
+                isRequired=False,
+            ),
+            objc.selector(
+                None,
+                b"exceptionHandler:shouldHandleException:mask:",
+                b"Z@:@@Q",
+                isRequired=False,
+            ),
+        ],
+    )
+}
+expressions = {
+    "NSHangOnEveryExceptionMask": "(NSHangOnUncaughtExceptionMask|NSHangOnUncaughtSystemExceptionMask|NSHangOnUncaughtRuntimeErrorMask|NSHangOnTopLevelExceptionMask|NSHangOnOtherExceptionMask)",
+    "NSLogAndHandleEveryExceptionMask": "(NSLogUncaughtExceptionMask|NSLogUncaughtSystemExceptionMask|NSLogUncaughtRuntimeErrorMask|NSHandleUncaughtExceptionMask|NSHandleUncaughtSystemExceptionMask|NSHandleUncaughtRuntimeErrorMask|NSLogTopLevelExceptionMask|NSHandleTopLevelExceptionMask|NSLogOtherExceptionMask|NSHandleOtherExceptionMask)",
+}
+
+# END OF FILE

PyObjCTools/Debugging.py

@@ -0,0 +1,222 @@
+"""
+Low level debugging helper for PyObjC.
+
+Allows you to log Python and ObjC (via atos) stack traces for NSExceptions
+raised.
+
+General guidelines for use:
+
+- It's typically only useful when you log EVERY exception, because Foundation
+  and AppKit will swallow most of them.  This means that you should never
+  use this module in a release build.
+
+- Typical use involves only calling installExceptionHandler or
+  installVerboseExceptionHandler.  It may be removed at any time by calling
+  removeDebuggingHandler.
+"""
+
+import os
+import sys
+import traceback
+
+import objc
+from ExceptionHandling import (
+    NSExceptionHandler,
+    NSLogAndHandleEveryExceptionMask,
+    NSLogUncaughtExceptionMask,
+    NSStackTraceKey,
+)
+from Foundation import NSLog, NSObject
+
+DEFAULTMASK = NSLogUncaughtExceptionMask
+EVERYTHINGMASK = NSLogAndHandleEveryExceptionMask
+
+
+__all__ = [
+    "LOGSTACKTRACE",
+    "DEFAULTVERBOSITY",
+    "DEFAULTMASK",
+    "EVERYTHINGMASK",
+    "installExceptionHandler",
+    "installVerboseExceptionHandler",
+    "installPythonExceptionHandler",
+    "removeExceptionHandler",
+    "handlerInstalled",
+]
+
+
+def isPythonException(exception):
+    if hasattr(exception, "_pyobjc_info_"):
+        return False
+
+    if not hasattr(exception, "userInfo"):
+        return True
+
+    return (exception.userInfo() or {}).get("__pyobjc_exc_type__") is not None
+
+
+def nsLogPythonException(exception):
+    userInfo = exception.userInfo()
+    NSLog(
+        "%@",
+        "*** Python exception discarded!\n"
+        + "".join(
+            traceback.format_exception(
+                userInfo["__pyobjc_exc_type__"],
+                userInfo["__pyobjc_exc_value__"],
+                userInfo["__pyobjc_exc_traceback__"],
+            )
+        ),
+    )
+    # we logged it, so don't log it for us
+    return False
+
+
+_atos_command = None
+
+
+def _run_atos(stack):
+    global _atos_command
+    if _atos_command is None:
+        if os.path.exists("/usr/bin/atos"):
+            _atos_command = "/usr/bin/atos"
+
+            if os.uname()[2].startswith("13."):
+                # The atos command on OSX 10.9 gives a usage
+                # warning that's suppressed with the "-d" option.
+                _atos_command += " -d"
+
+        elif os.path.exists("/usr/bin/xcrun"):
+            _atos_command = "/usr/bin/xcrun atos"
+
+        else:
+            return None
+
+    return os.popen(f"{_atos_command} -p {os.getpid()} {stack}")
+
+
+def nsLogObjCException(exception):
+    stacktrace = None
+
+    try:
+        stacktrace = exception.callStackSymbols()
+
+    except AttributeError:
+        pass
+
+    if stacktrace is None:
+        stack = exception.callStackReturnAddresses()
+        if stack:
+            pipe = _run_atos(" ".join(hex(v) for v in stack))
+            if pipe is None:
+                return True
+
+            stacktrace = pipe.readlines()
+            stacktrace.reverse()
+            pipe.close()
+
+    if stacktrace is None:
+        userInfo = exception.userInfo()
+        stack = userInfo.get(NSStackTraceKey)
+        if not stack:
+            return True
+
+        pipe = _run_atos(stack)
+        if pipe is None:
+            return True
+
+        stacktrace = pipe.readlines()
+        stacktrace.reverse()
+        pipe.close()
+
+    NSLog(
+        "%@",
+        "*** ObjC exception '%s' (reason: '%s') discarded\n"
+        % (exception.name(), exception.reason())
+        + "Stack trace (most recent call last):\n"
+        + "".join([("  " + line) for line in stacktrace]),
+    )
+    return False
+
+
+LOGSTACKTRACE = 1 << 0
+DEFAULTVERBOSITY = 0
+
+
+class PyObjCDebuggingDelegate(NSObject):
+    verbosity = objc.ivar("verbosity", b"i")
+
+    def initWithVerbosity_(self, verbosity):
+        self = self.init()
+        self.verbosity = verbosity
+        return self
+
+    @objc.typedSelector(b"c@:@@I")
+    def exceptionHandler_shouldLogException_mask_(self, sender, exception, aMask):
+        try:
+            if isPythonException(exception):
+                if self.verbosity & LOGSTACKTRACE:
+                    nsLogObjCException(exception)
+                return nsLogPythonException(exception)
+            elif self.verbosity & LOGSTACKTRACE:
+                return nsLogObjCException(exception)
+            else:
+                return False
+        except:  # noqa: B001, E722
+            print(
+                "*** Exception occurred during exception handler ***", file=sys.stderr
+            )
+            traceback.print_exc(sys.stderr)
+            return True
+
+    @objc.typedSelector(b"c@:@@I")
+    def exceptionHandler_shouldHandleException_mask_(self, sender, exception, aMask):
+        return False
+
+
+def installExceptionHandler(verbosity=DEFAULTVERBOSITY, mask=DEFAULTMASK):
+    """
+    Install the exception handling delegate that will log every exception
+    matching the given mask with the given verbosity.
+    """
+    # we need to retain this, cause the handler doesn't
+    global _exceptionHandlerDelegate
+    delegate = PyObjCDebuggingDelegate.alloc().initWithVerbosity_(verbosity)
+    NSExceptionHandler.defaultExceptionHandler().setExceptionHandlingMask_(mask)
+    NSExceptionHandler.defaultExceptionHandler().setDelegate_(delegate)
+    _exceptionHandlerDelegate = delegate
+
+
+def installPythonExceptionHandler():
+    """
+    Install a verbose exception handling delegate that logs every exception
+    raised.
+
+    Will log only Python stack traces, if available.
+    """
+    installExceptionHandler(verbosity=DEFAULTVERBOSITY, mask=EVERYTHINGMASK)
+
+
+def installVerboseExceptionHandler():
+    """
+    Install a verbose exception handling delegate that logs every exception
+    raised.
+
+    Will log both Python and ObjC stack traces, if available.
+    """
+    installExceptionHandler(verbosity=LOGSTACKTRACE, mask=EVERYTHINGMASK)
+
+
+def removeExceptionHandler():
+    """
+    Remove the current exception handler delegate
+    """
+    NSExceptionHandler.defaultExceptionHandler().setDelegate_(None)
+    NSExceptionHandler.defaultExceptionHandler().setExceptionHandlingMask_(0)
+
+
+def handlerInstalled():
+    """
+    Is an exception handler delegate currently installed?
+    """
+    return NSExceptionHandler.defaultExceptionHandler().delegate() is not None

pyobjc_framework_ExceptionHandling-10.3.2.dist-info/LICENSE.txt

@@ -0,0 +1,10 @@
+(This is the MIT license, note that libffi-src is a separate product with its own license)
+
+Copyright 2002, 2003 - Bill Bumgarner, Ronald Oussoren, Steve Majewski, Lele Gaifax, et.al.
+Copyright 2003-2024 - Ronald Oussoren
+
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

pyobjc_framework_ExceptionHandling-10.3.2.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.1
+Name: pyobjc-framework-ExceptionHandling
+Version: 10.3.2
+Summary: Wrappers for the framework ExceptionHandling on macOS
+Home-page: https://github.com/ronaldoussoren/pyobjc
+Author: Ronald Oussoren
+Author-email: pyobjc-dev@lists.sourceforge.net
+License: MIT License
+Keywords: PyObjC,ExceptionHandling
+Platform: MacOS X
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: MacOS X :: Cocoa
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Objective C
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst; charset=UTF-8
+License-File: LICENSE.txt
+Requires-Dist: pyobjc-core>=10.3.2
+Requires-Dist: pyobjc-framework-Cocoa>=10.3.2
+Project-URL: Documentation, https://pyobjc.readthedocs.io/en/latest/
+Project-URL: Issue tracker, https://github.com/ronaldoussoren/pyobjc/issues
+Project-URL: Repository, https://github.com/ronaldoussoren/pyobjc
+
+
+Wrappers for the "ExceptionHandling" framework on macOS. The ExceptionHandling
+framework provides facilities for monitoring and debugging exceptional
+conditions in Cocoa programs.
+
+PyObjC also provides low-level debugging utilities beyond the core
+ExceptionHandling framework in the module ``PyObjCTools.Debugging``.
+
+These wrappers don't include documentation, please check Apple's documentation
+for information on how to use this framework and PyObjC's documentation
+for general tips and tricks regarding the translation between Python
+and (Objective-)C frameworks
+
+
+Project links
+-------------
+
+* `Documentation <https://pyobjc.readthedocs.io/en/latest/>`_
+
+* `Issue Tracker <https://github.com/ronaldoussoren/pyobjc/issues>`_
+
+* `Repository <https://github.com/ronaldoussoren/pyobjc/>`_
+

pyobjc_framework_ExceptionHandling-10.3.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+ExceptionHandling/__init__.py,sha256=8CWyoEPdIYpP6d3HgdqPSN8SkwJ3xVRhkb435iHJdPs,880
+ExceptionHandling/_metadata.py,sha256=IsCzCyj877M_h2pvGZTSHwYEKzesdoT0XF7UWkd2l_s,2770
+PyObjCTools/Debugging.py,sha256=H05RL2YGsGMhl-czhn_wbCIuogetBHRr2-t0jXkSwoY,6164
+pyobjc_framework_ExceptionHandling-10.3.2.dist-info/LICENSE.txt,sha256=VBYOCJp5HziM90a14Txl68gt3y2rIJpcoZAoVkfX4Ho,1249
+pyobjc_framework_ExceptionHandling-10.3.2.dist-info/METADATA,sha256=tAfukXwDBGs55OSWbM1zGuVW5OWoMEHPb2ij7u8zjRQ,2550
+pyobjc_framework_ExceptionHandling-10.3.2.dist-info/WHEEL,sha256=pxeNX5JdtCe58PUSYP9upmc7jdRPgvT0Gm9kb1SHlVw,109
+pyobjc_framework_ExceptionHandling-10.3.2.dist-info/top_level.txt,sha256=9dZWP3ne-rbt6Zo7CxEHR5dISz4ZAn4PknLp-VV8bXs,30
+pyobjc_framework_ExceptionHandling-10.3.2.dist-info/RECORD,,

pyobjc_framework_ExceptionHandling-10.3.2.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.6.0)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+

pyobjc_framework_ExceptionHandling-10.3.2.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+ExceptionHandling
+PyObjCTools