PyObjC: AVRouting Framework

Warnings

• breaking PyObjC 12.0 dropped support for Python 3.9.
  Fix: Upgrade to Python 3.10 or newer (Python 3.10 is the minimum for PyObjC 12.x).
• breaking PyObjC 11.0 dropped support for Python 3.8.
  Fix: Upgrade to Python 3.9 or newer (Python 3.10 is the minimum for PyObjC 12.x).
• gotcha Installing PyObjC from source (or in some edge cases even binary wheels) requires Apple's Xcode Command Line Tools to be installed on your macOS system.
  Fix: Run `xcode-select --install` in your terminal to install the necessary tools.
• gotcha Behavior around `__init__` when `__new__` is implemented in Python subclasses of Objective-C classes changed in PyObjC 10.3 and was partially reverted in 10.3.1. This can affect custom initializers.
  Fix: Review Python subclasses that implement both `__new__` and `__init__` if upgrading from pre-10.3.1. Consult PyObjC release notes for details.
• gotcha PyObjC 11.1 introduced alignment with `clang`'s Automatic Reference Counting (ARC) for initializer methods (methods in the 'init' family), which now correctly model reference stealing and returning new references. This might subtly change memory management behavior for custom Objective-C class wrappers.
  Fix: Review custom Objective-C class wrappers, especially `init` methods, for potential changes in reference counting behavior.
• gotcha Key-Value Observing (KVO) usage is automatically disabled for subclasses of `NSProxy` defined in Python to prevent `SystemError`.
  Fix: If you relied on KVO with Python `NSProxy` subclasses, this behavior is now implicitly disabled. Re-evaluate if KVO is strictly necessary or if an alternative observation pattern can be used.

Install

• pip install pyobjc-framework-avrouting Install latest version

Imports

• AVRouting

  import AVRouting

  All classes, functions, and constants from the AVRouting framework are made available under this module.

Quickstart

This quickstart demonstrates how to import the `AVRouting` framework and instantiate a basic class like `AVCustomRoutingController`. Full functionality of the `AVRouting` framework typically requires integration with other macOS services, UI elements like `AVRoutePickerView`, and the implementation of delegate protocols as detailed in Apple's `AVRouting` documentation.

import AVRouting
import objc

def main():
    # Instantiate a core AVRouting class. AVCustomRoutingController manages custom device routes.
    # Actual functionality requires deeper integration with macOS services and delegates, 
    # typically within a full Cocoa application context, as per Apple's AVRouting documentation.
    controller = AVRouting.AVCustomRoutingController.alloc().init()
    
    # Example of accessing a property (if available, consult Apple's docs for specifics)
    # This particular property needs a delegate or further setup to be meaningful.
    # For demonstration, we just show instantiation.
    print(f"AVRouting.AVCustomRoutingController instance created: {controller}")

    # To make sure PyObjC is properly initialized in a non-GUI context
    # This is often handled implicitly in Cocoa applications, but good for standalone scripts.
    objc.autoreleasepool(lambda: main_logic())

def main_logic():
    # Your main PyObjC logic goes here
    pass # The example already does the print in the outer main

if __name__ == '__main__':
    main()