{"library":"pyobjc-framework-mailkit","title":"PyObjC MailKit Framework","description":"The `pyobjc-framework-mailkit` library provides Python wrappers for the macOS MailKit framework. MailKit allows developers to extend the functionality of Apple Mail, primarily through Mail app extensions. As part of the larger PyObjC project, it enables Python applications to interact with native macOS Objective-C APIs. The current version is 12.1, with releases typically tied to macOS SDK updates and Python version compatibility.","language":"python","status":"active","last_verified":"Sat May 16","install":{"commands":["pip install pyobjc-framework-mailkit"],"cli":null},"imports":["from MailKit import MKMailExtension","from MailKit import MKMessage","from Foundation import NSString"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import objc\nfrom Foundation import NSString, NSLog\n\n# This example demonstrates basic PyObjC usage. MailKit classes\n# (e.g., MKMailExtension) primarily function within a Mail app extension\n# context on macOS, not as standalone scripts.\n\ntry:\n    # Create a Python string\n    python_string = \"Hello from PyObjC MailKit environment!\"\n\n    # Convert it to an Objective-C NSString using a convenience method\n    objc_string = NSString.stringWithString_(python_string)\n\n    # Log the Objective-C string using NSLog\n    NSLog(\"%@\", objc_string)\n\n    print(f\"Python string: {python_string} (type: {type(python_string)})\")\n    print(f\"Objective-C NSString: {objc_string} (type: {type(objc_string)})\")\n    print(f\"Length of NSString: {objc_string.length()}\")\n\n    # Attempting to import a MailKit class to show the pattern\n    # from MailKit import MKMailExtension # This import might fail if not specifically linked or on older macOS\n    # if 'MKMailExtension' in globals():\n    #     print(\"MKMailExtension class is available (but requires Mail extension context for use).\")\n    # else:\n    #     print(\"MKMailExtension class not directly available in this standalone context (expected).\")\n\nexcept Exception as e:\n    print(f\"An error occurred during PyObjC interaction: {e}\")\n    print(\"Ensure you are on macOS and the PyObjC environment is correctly set up.\")","lang":"python","description":"This quickstart demonstrates basic Objective-C object interaction using `Foundation.NSString` via PyObjC. While it doesn't directly use a MailKit class, it shows the general pattern for importing and interacting with Objective-C frameworks. MailKit classes, such as `MKMailExtension`, are typically instantiated and used within the specific context of a Mail app extension on macOS, and not as standalone Python scripts.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":null,"pypi_latest":"12.1","is_stale":null,"summary":{"python_range":"3.10–3.9","success_rate":0,"avg_install_s":null,"avg_import_s":null,"wheel_type":null},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pyobjc-framework-mailkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pyobjc-framework-mailkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":3.3,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pyobjc-framework-mailkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pyobjc-framework-mailkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":3.1,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pyobjc-framework-mailkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pyobjc-framework-mailkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":3,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pyobjc-framework-mailkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pyobjc-framework-mailkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":2.6,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pyobjc-framework-mailkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pyobjc-framework-mailkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":3.8,"import_time_s":null,"mem_mb":null,"disk_size":null}]}}