Registry / type-stubs / pyobjc-framework-quartz

pyobjc-framework-quartz

library12.2.2pypypiunverified

PyObjC Framework Quartz provides Python bindings and wrappers for the Quartz frameworks on macOS, enabling Python applications to interact with macOS's core graphics, windowing, and display services. It is part of the larger PyObjC bridge, building upon pyobjc-core. The current version is 12.1, and new versions are typically released in alignment with macOS SDK updates.

type-stubs

pip install pyobjc-framework-quartz

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · PYOBJC-FRAMEWORK-Q

pyobjc-framework-quartz

type-stubspythonv12.2.2

Install

—

Import

—

Disk

—

Pass rate

0/ 10

Env Coverage0 / 10

glibc

3.9–3.13

musl

3.9–3.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.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

build_error

Code

Verified usage

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

Quartz

✓ import Quartz

CGMainDisplayID

✓ from Quartz import CGMainDisplayID

This example demonstrates how to import the Quartz framework and use its Core Graphics functions to retrieve fundamental information about the primary display, such as its identifier and current pixel bounds.

import Quartz # Get the main display ID main_display_id = Quartz.CGMainDisplayID() # Get the bounds of the main display main_display_bounds = Quartz.CGDisplayBounds(main_display_id) print(f"Main Display ID: {main_display_id}") print(f"Main Display Bounds: {main_display_bounds}") print(f"Origin: ({main_display_bounds.origin.x}, {main_display_bounds.origin.y})") print(f"Size: ({main_display_bounds.size.width}, {main_display_bounds.size.height})")

Debug

Known issues

breakingPyObjC has dropped support for older Python versions. Version 12.0 dropped support for Python 3.9, and version 11.0 dropped Python 3.8. Ensure your environment meets the current minimum requirement (Python >=3.10).

fix

Upgrade your Python interpreter to 3.10 or newer, or use an older `pyobjc` release compatible with your Python version.

affects: >=11.0

breakingVersion 11.1 introduced a significant change in how PyObjC handles memory management for Objective-C 'init' family methods, aligning with clang's Automatic Reference Counting (ARC) documentation. This change in object ownership semantics can lead to memory leaks or crashes in existing code that manually manages references.

fix

Carefully review and adapt any Python code that directly interacts with Objective-C `init` methods or performs manual memory management to ensure it adheres to the new ARC model.

affects: >=11.1

gotchaThe interaction between Python's `__init__` and `__new__` methods when subclassing Objective-C classes can be complex. While `v10.3` initially restricted `__init__` calls, `v10.3.1` partially re-enabled it for classes with a user-implemented `__new__`. However, classes relying on PyObjC's default `__new__` still cannot use `__init__`.

fix

If experiencing issues with object initialization during subclassing, review the `pyobjc-core` documentation on `__init__`/`__new__` behavior and ensure your class's construction aligns with PyObjC's Objective-C integration rules.

affects: >=10.3

gotchaPyObjC v11.0 introduced experimental support for Python's free-threading (PEP 703) for Python 3.13+. However, earlier versions (e.g., v10.3) explicitly stated no support for free threading. Using PyObjC with free-threading, especially outside Python 3.13+ or in ways not fully tested, might lead to unstable behavior.

fix

Consult the `pyobjc` documentation regarding free-threading compatibility for your specific version and Python interpreter. Exercise caution and thorough testing if utilizing free-threading features.

affects: >=10.3, <=11.0

Upgrade

Version history

12.2.2latest on PyPI · released Aug 11, 2026

Audit

Dependencies

pyobjc-corerequiredCore bridge for Objective-C and Python, required by all PyObjC framework packages.

Agent activity

26 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/ronaldoussoren/pyobjc ↗

packagehttps://pypi.org/project/pyobjc-framework-quartz/ ↗

docshttps://pyobjc.readthedocs.io/en/latest/ ↗