PyObjC Framework: DiskArbitration

12.1 · active · verified Tue Apr 14

This library provides Python wrappers for Apple's DiskArbitration framework on macOS, enabling programmatic interaction with disk management, mount/unmount events, and disk information. It is part of the larger PyObjC project, currently at version 12.1, with a release cadence often synchronized with macOS SDK updates and Python version support.

Warnings

breaking PyObjC 12.0 dropped support for Python 3.9, and PyObjC 11.0 dropped support for Python 3.8. Users on these older Python versions must use an earlier PyObjC version.
Fix: Upgrade Python to 3.10 or later, or pin pyobjc-framework-diskarbitration to a compatible version (e.g., `<12.0` for Python 3.9 users, `<11.0` for Python 3.8 users).
breaking PyObjC 11.1 introduced significant changes in how initializer methods (`init` family) are handled for Automatic Reference Counting (ARC), aligning with clang's documentation. This can alter reference counting behavior for custom Objective-C classes or Python subclasses.
Fix: Carefully review custom `__new__` and `__init__` implementations in Python subclasses of Objective-C objects, especially those involving memory management, to ensure they comply with the new ARC semantics.
gotcha The interaction between Objective-C object initialization (`alloc`/`init`) and Python's `__new__`/`__init__` can be complex. PyObjC 10.3 temporarily broke the ability to call `__init__` after `__new__` for some cases, which was partially reverted in 10.3.1. Code relying on custom `__new__` might behave unexpectedly.
Fix: For subclasses implementing `__new__`, ensure `__init__` is called correctly. If encountering issues, test on 10.3.1 or later. Avoid directly calling `super().__init__` on `objc.objc_object` when using PyObjC's provided `__new__`.
gotcha While Python 3.13 introduces experimental free-threading (PEP 703), PyObjC 10.3 explicitly stated it did not support it. PyObjC 11.0 added *experimental* free-threading support. Using PyObjC in a free-threaded environment before full, stable support could lead to instability or incorrect behavior.
Fix: If working with Python 3.13 or newer, be aware that free-threading support in PyObjC is still experimental. Avoid using PyObjC in a free-threaded context unless absolutely necessary and with thorough testing, or wait for a stable release with full free-threading guarantees.

Install

pip install pyobjc-framework-diskarbitration Install specific framework
pip install pyobjc Install all PyObjC frameworks (recommended)

Imports

DiskArbitration
```
import DiskArbitration
```

Quickstart

This quickstart demonstrates how to import the DiskArbitration framework and create a basic session. It verifies that the framework is correctly loaded and accessible, releasing the session immediately as a full-fledged DiskArbitration application typically involves event loops and callbacks.

import DiskArbitration
import CoreFoundation

# Create a DiskArbitration session
session = DiskArbitration.DASessionCreate(CoreFoundation.kCFAllocatorDefault)

if session:
    print("DiskArbitration session created successfully.")
    # In a real application, you would register callbacks, e.g., using DASessionScheduleWithRunLoop
    # For a quick demo, we just verify session creation and release it.
    CoreFoundation.CFRelease(session)
else:
    print("Failed to create DiskArbitration session.")

view raw JSON →