PyObjC SecurityFoundation Framework

Warnings

• breaking Python Version Support Drops: PyObjC has a policy of dropping support for older Python versions. PyObjC 12.0 dropped support for Python 3.9, and PyObjC 11.0 dropped support for Python 3.8. Always consult the release notes to ensure compatibility with your target Python and macOS versions.
  Fix: Upgrade Python to a supported version (e.g., Python 3.10+ for PyObjC 12.1).
• breaking Changes in `__init__` and `__new__` behavior: In PyObjC 10.3, calling `__init__` on subclasses that rely on PyObjC's `__new__` was disabled. While partially reintroduced in 10.3.1 for user-implemented `__new__`, code relying on the PyObjC-provided `__new__` cannot use `__init__`. This can break existing subclassing patterns.
  Fix: Adopt the `alloc().init()` pattern for object creation, or ensure `__new__` is explicitly implemented by the user if `__init__` is needed.
• breaking Removal of `IMServicePlugIn` Bindings: The `IMServicePlugIn` framework bindings were entirely removed in PyObjC 10.0, as the underlying framework was deprecated by Apple in macOS 10.13 and removed in macOS 14.
  Fix: Remove any dependencies on `IMServicePlugIn`. Applications needing similar functionality may need to find alternative macOS APIs or adjust their design.
• gotcha KVO (Key-Value Observing) for `NSProxy` Subclasses: As of PyObjC 12.1, KVO usage is automatically disabled for Python subclasses of `NSProxy`. Attempting to use KVO with these subclasses can lead to `SystemError`.
  Fix: Avoid using KVO with Python subclasses of `NSProxy`. If KVO-like functionality is required, implement a custom observation mechanism.
• gotcha `os.fspath` with Cocoa URLs: Prior to PyObjC 10.1, `os.fspath()` would raise a `TypeError` when used with Cocoa URL objects (`NSURL`, `CFURLRef`) that referred to local filesystem paths. This was fixed in 10.1.
  Fix: If using PyObjC versions older than 10.1, convert Cocoa URL objects to Python string paths manually before passing them to `os.fspath()`. Upgrade to 10.1 or newer to use `os.fspath()` directly.
• gotcha `bytearray` as C `char*` argument: In versions prior to 12.1, passing a `bytearray` directly to an Objective-C function or selector expecting a null-terminated C char array might have required manual conversion. As of 12.1, `bytearray` instances can be used directly.
  Fix: For older versions, ensure `bytearray` is explicitly converted (e.g., `str(b.decode('utf-8'))` or `b'...' + b'\0'`) if a null-terminated C string is expected. Upgrade to 12.1+ to use `bytearray` directly.

Install

• pip install pyobjc-framework-securityfoundation Install PyObjC SecurityFoundation

Imports

• SFAuthorization

  from SecurityFoundation import SFAuthorization

  PyObjC maps macOS frameworks to Python packages with the same name. SFAuthorization is the primary class in the SecurityFoundation framework.

Quickstart

This quickstart demonstrates how to import the `SecurityFoundation` framework and obtain a default `SFAuthorization` object, which is a core component for interacting with macOS Authorization Services.

import SecurityFoundation
import objc

# Get a default SFAuthorization object
auth = SecurityFoundation.SFAuthorization.authorization()

if auth:
    print(f"Successfully obtained SFAuthorization object: {auth}")
    # Further operations would involve using methods on the 'auth' object
    # to perform authorization checks or privilege escalation.
else:
    print("Failed to obtain SFAuthorization object.")