PyObjC PhotosUI Framework

Warnings

• breaking Python 3.9 support was dropped in PyObjC 12.0. Python 3.8 support was dropped in PyObjC 11.0.
  Fix: Upgrade to Python 3.10 or later for PyObjC 12.x, or Python 3.9 or later for PyObjC 11.x. Always use a Python version supported by your PyObjC version.
• breaking PyObjC 11.1 aligned the core bridge's behavior with `clang`'s Automatic Reference Counting (ARC) documentation for initializer methods. Methods in the 'init' family now correctly steal a reference to `self` and return a new reference.
  Fix: Existing code should review object instantiation patterns, especially custom subclasses of Objective-C classes, to ensure correct reference handling, though PyObjC manages most ARC complexities internally. This primarily affects advanced users subclassing Objective-C objects.
• breaking The interaction between Python's `__init__` and `__new__` methods when subclassing Objective-C classes changed in PyObjC 10.3, leading to breakage for some projects. While partially reverted in 10.3.1, code relying on `__new__` provided by PyObjC cannot use `__init__`.
  Fix: If implementing `__new__` in a Python subclass of an Objective-C class, ensure `__init__` is not called if `__new__` is meant to handle object initialization entirely, or structure your class hierarchy to avoid conflicts. Refer to PyObjC documentation on object instantiation.
• deprecated The 'IMServicePlugIn' framework bindings were removed in PyObjC 10.0 as the framework itself was deprecated in macOS 10.13 and removed in macOS 14.
  Fix: Migrate away from IMServicePlugIn to current Apple APIs if your application relies on this functionality. This warning is specific to the `pyobjc-framework-IMServicePlugIn` package, but is a relevant major version change within the broader PyObjC ecosystem.
• gotcha PyObjC requires the Xcode Command Line Tools to be installed on macOS for building and sometimes even for installation.
  Fix: Run `xcode-select --install` in your terminal to ensure the command line tools are present.
• gotcha Objective-C object instantiation is a two-step process (`alloc()` then `init...()`). While PyObjC allows calling the class directly for many cases, understanding this underlying mechanism is crucial for complex or custom object creation.
  Fix: When `ClassName(...)` doesn't work as expected, explicitly use `ClassName.alloc().init(...)` or `ClassName.alloc().initWithArgument(...)` patterns. Consult Apple's Objective-C documentation for the specific class's initialization methods.

Install

• pip install pyobjc-framework-photosui Install latest version

Imports

• PhotosUI

  import PhotosUI

  The PhotosUI framework is exposed directly as a Python package.

Quickstart

This quickstart demonstrates how to import the `PhotosUI` framework and access a class within it. Most `PhotosUI` functionalities require a running Cocoa application, typically managed via `AppKit.NSApplication`. This snippet initializes the shared application (without starting its run loop) and attempts to access `PHLivePhotoView` to confirm the bindings are loaded. Full UI interactions would require more extensive setup.

import PhotosUI
import Foundation
import AppKit

# Most PhotosUI interactions require a running Cocoa application.
# This snippet demonstrates basic import and class access.
# For a functional UI example, a full PyObjC app setup with NSApplication is required.

def main():
    # Initialize a basic NSApplication (required for most Cocoa frameworks)
    app = AppKit.NSApplication.sharedApplication()
    
    # Access a PhotosUI class to confirm the framework is loaded
    try:
        # PHLivePhotoView is a common PhotosUI class introduced in iOS/macOS 10.11
        _ = PhotosUI.PHLivePhotoView
        print("Successfully imported PhotosUI and accessed PHLivePhotoView.")
    except AttributeError:
        print("Could not access PHLivePhotoView. Ensure macOS version supports PhotosUI and PyObjC is correctly installed.")
    
    # Note: A real PhotosUI application would involve delegates, windows, and an event loop.
    # app.run() # This would start the GUI event loop, blocking further execution.

if __name__ == '__main__':
    main()