Registry / pyobjc-framework-fileprovider

pyobjc-framework-fileprovider

JSON →
library12.2pypypiunverified

PyObjC-framework-FileProvider provides Python bindings for Apple's FileProvider framework on macOS. It is part of the larger PyObjC project, which offers wrappers for most Objective-C frameworks, enabling Python developers to build macOS applications and interact with system APIs. The project is actively maintained, with new releases typically accompanying macOS SDK updates and adjustments for Python version support.

pip install pyobjc-framework-fileprovider
INSTALL
IMPORT
SIG · PYOBJC-FRAMEWORK-F
P
pyobjc-framework-fileprovider
pythonv12.2
Install
Import
Disk
Pass rate
0/ 10
Env Coverage0 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v? · pip install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.920 runs
build_error
glibc
py 3.103.920 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

FileProvider
import FileProvider

This quickstart demonstrates how to import the FileProvider framework and access a basic class. Note that full functionality of the FileProvider framework typically requires implementation within a macOS application extension, often involving an Objective-C runtime loop which PyObjC can integrate with.

import FileProvider import Foundation print(f"FileProvider framework loaded: {FileProvider}") # Access a class from the FileProvider framework. # For a real application, you would typically interact with FileProvider APIs # within a macOS application extension context. # This example merely demonstrates that the binding can load and access a class. try: manager_class = FileProvider.NSFileProviderManager print(f"Successfully accessed NSFileProviderManager class: {manager_class}") # Further interaction would depend on the specific FileProvider extension logic, # which often involves running an application loop. # For instance: # from PyObjCTools import AppHelper # AppHelper.runEventLoop() except AttributeError as e: print(f"Error accessing FileProvider class: {e}. This might indicate the class is not present in this macOS version or SDK.") except Exception as e: print(f"An unexpected error occurred: {e}")
Debug
Known issues
breakingPyObjC frequently drops support for older Python versions. PyObjC 12.0 dropped support for Python 3.9, and PyObjC 11.0 dropped support for Python 3.8. Ensure your Python version meets the `requires_python` specification for the PyObjC version you are using.
fix
Upgrade to a supported Python version (3.10+ for PyObjC 12.1) or pin an older PyObjC version compatible with your Python environment.
affects: >=11.0
breakingIn PyObjC 11.1, the behavior of initializer methods (`init` family) was aligned with `clang`'s Automatic Reference Counting documentation. This change affects how references are handled for `init` methods, which may break existing code relying on PyObjC's prior reference counting semantics for these methods.
fix
Review code interacting with Objective-C `init` methods, especially those involving manual reference counting or complex object graph setups, to ensure compatibility with the updated ARC model.
affects: >=11.1
gotchaPyObjC translates Objective-C selectors (message names with colons) into Python method names by replacing colons with underscores. For example, `[obj doSomething:arg1 withSomethingElse:arg2]` becomes `obj.doSomething_withSomethingElse_(arg1, arg2)`. Understanding this naming convention is crucial for calling Objective-C methods from Python.
fix
Always convert Objective-C selector colons (`:`) to underscores (`_`) when calling methods from Python, and ensure the correct number of arguments are passed.
affects: all
gotchaWhile PyObjC 12.x aims for stable support of Python's experimental free-threading (PEP 703) with Python 3.13+, earlier PyObjC versions had limitations. PyObjC 10.x explicitly did not support free-threading, and PyObjC 11.x offered only experimental support. Using older PyObjC versions with free-threading Python interpreters may lead to instability or incorrect behavior.
fix
For Python 3.13+ with free-threading, ensure you are using PyObjC 12.x or later. For older PyObjC versions, avoid using Python interpreters with experimental free-threading enabled.
affects: <12.0 (with Python 3.13+)
deprecatedPyObjC removes bindings for macOS frameworks that Apple deprecates and removes from the operating system. For instance, the `IMServicePlugIn` bindings were removed in PyObjC 10.0 because the framework was deprecated in macOS 10.13 and removed in macOS 14. Applications targeting older macOS versions might require specific older PyObjC framework versions.
fix
Before upgrading PyObjC, check the release notes for removed framework bindings if your application relies on older or less common macOS frameworks. If necessary, pin an older PyObjC version compatible with your target macOS and framework requirements.
affects: >=10.0
Upgrade
Version history
12.2latest on PyPI · released May 30, 2026
Audit
Dependencies
pyobjc-corerequiredAll PyObjC framework wrappers rely on the core bridging library.
Agent activity
4 hits · last 30 days
node
4
Resources
pyobjc-framework-fileprovider — pip install pyobjc-framework-fileprovider · libregistry