PyObjC Framework IOBluetooth

Warnings

• breaking PyObjC 12.0 dropped support for Python 3.9. Users on Python 3.9 must use an older version of pyobjc-framework-iobluetooth (or the full pyobjc package).
  Fix: Upgrade to Python 3.10 or newer, or pin `pyobjc-framework-iobluetooth<12.0`.
• breaking PyObjC 11.0 dropped support for Python 3.8. Users on Python 3.8 must use an older version of pyobjc-framework-iobluetooth (or the full pyobjc package).
  Fix: Upgrade to Python 3.9 or newer, or pin `pyobjc-framework-iobluetooth<11.0`.
• breaking Version 11.1 changed how initializer methods (methods in the 'init' family) handle references, aligning with `clang`'s Automatic Reference Counting (ARC) documentation. This means `init` methods now steal a reference to `self` and return a new one, which can alter object lifecycle management.
  Fix: Review code interacting with Objective-C `init` methods for potential reference counting issues and adjust accordingly.
• gotcha PyObjC is a macOS-specific bridge. `pyobjc-framework-iobluetooth` will only function on macOS and cannot be used on other operating systems.
  Fix: Ensure deployment environment is macOS. Use cross-platform alternatives for Bluetooth interaction if multi-OS support is required.
• gotcha Changes in `__init__` and `__new__` behavior in versions 10.3 and 10.3.1 can cause issues. While `__init__` was initially disabled when PyObjC provided `__new__` (v10.3), it was re-enabled for user-implemented `__new__` (v10.3.1). This interaction can be tricky for custom class creation patterns.
  Fix: If defining custom `__new__` or `__init__` for Objective-C classes, thoroughly test object initialization and lifecycle. Consider moving complex initialization logic to Objective-C methods if encountering issues.
• gotcha Installing PyObjC and its framework bindings may require Apple's Xcode Command Line Tools to be installed, especially for certain Python versions or environments.
  Fix: Run `xcode-select --install` in the terminal to ensure Command Line Tools are present before installation.

Install

• pip install pyobjc-framework-iobluetooth Install latest version

Imports

• IOBluetooth

  import IOBluetooth

  The primary module for accessing IOBluetooth framework functionality.
• objc

  import objc

  The underlying PyObjC bridge module, often needed for advanced interactions or to use PyObjC utilities like `objc.ObjCLazyModule`.
• NSObject, NSBundle

  from Foundation import NSObject, NSBundle

  Common base classes and utilities from the Foundation framework, frequently used when working with any Objective-C framework.

Quickstart

This quickstart demonstrates how to import the `IOBluetooth` framework using PyObjC and perform a basic check by accessing a class (`IOBluetoothDevice`) and its associated bundle. This confirms the successful loading and accessibility of the Objective-C framework through Python. For more in-depth usage, refer to Apple's IOBluetooth documentation.

import objc
from Foundation import NSBundle
import IOBluetooth

# Verify that the IOBluetooth framework is loaded and accessible
print(f"IOBluetooth module loaded: {IOBluetooth is not None}")

if IOBluetooth is not None:
    # Access a common class from the IOBluetooth framework, e.g., IOBluetoothDevice
    # and try to get its bundle identifier to confirm functionality.
    device_class = IOBluetooth.IOBluetoothDevice
    if device_class:
        print(f"Successfully accessed IOBluetoothDevice class: {device_class}")
        # Get the bundle for the class to show a more concrete interaction
        bundle = NSBundle.bundleForClass_(device_class)
        if bundle:
            print(f"IOBluetooth bundle identifier: {bundle.bundleIdentifier()}")
        else:
            print("Could not retrieve bundle for IOBluetoothDevice class.")
    else:
        print("Failed to access IOBluetoothDevice class.")