quickmacapp 2025.4.4__tar.gz → 2025.4.15__tar.gz

{quickmacapp-2025.4.4 → quickmacapp-2025.4.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quickmacapp
-Version: 2025.4.4
+Version: 2025.4.15
 Summary: Make it easier to write Mac apps in Python
 Description-Content-Type: text/x-rst
 License-File: LICENSE

{quickmacapp-2025.4.4 → quickmacapp-2025.4.15}/pyproject.toml

@@ -9,7 +9,7 @@ build-backend = "setuptools.build_meta"
 name = "quickmacapp"
 description = "Make it easier to write Mac apps in Python"
 readme = "README.rst"
-version = "2025.04.04"
+version = "2025.04.15"
 dependencies = [
     "pyobjc-framework-Cocoa",
     "pyobjc-framework-ExceptionHandling",

{quickmacapp-2025.4.4 → quickmacapp-2025.4.15}/src/quickmacapp/_notifications.py

@@ -1,36 +1,43 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from zoneinfo import ZoneInfo
 from types import TracebackType
 from typing import Any, Awaitable, Callable, Protocol, TypeAlias
+from zoneinfo import ZoneInfo
 
 from datetype import DateTime
-
-from Foundation import NSError, NSLog, NSObject, NSDateComponents
+from Foundation import (
+    NSTimeZone,
+    NSDateComponents,
+    NSError,
+    NSLog,
+    NSObject,
+    NSCalendar,
+    NSCalendarIdentifierGregorian,
+)
 from objc import object_property
 from twisted.internet.defer import Deferred
 from UserNotifications import (
-    UNNotificationCategoryOptions,
     UNAuthorizationOptionNone,
+    UNCalendarNotificationTrigger,
     UNMutableNotificationContent,
     UNNotification,
     UNNotificationAction,
-    UNNotificationActionOptions,
     UNNotificationActionOptionAuthenticationRequired,
     UNNotificationActionOptionDestructive,
     UNNotificationActionOptionForeground,
+    UNNotificationActionOptions,
     UNNotificationCategory,
     UNNotificationCategoryOptionAllowInCarPlay,
     UNNotificationCategoryOptionHiddenPreviewsShowSubtitle,
     UNNotificationCategoryOptionHiddenPreviewsShowTitle,
+    UNNotificationCategoryOptions,
     UNNotificationPresentationOptionBanner,
     UNNotificationPresentationOptions,
     UNNotificationRequest,
     UNNotificationResponse,
     UNNotificationSettings,
     UNNotificationTrigger,
-    UNCalendarNotificationTrigger,
     UNTextInputNotificationAction,
     UNUserNotificationCenter,
 )
@@ -178,7 +185,7 @@ class NotificationTranslator[T](Protocol):
         The application has requested to send a notification to the operating
         system, serialize the Python object represneting this category of
         notification into a 2-tuple of C{notificatcionID}, C{userData} that can
-        be encapsulated in a L{UNNotificationRequest}.
+        be encapsulated in a C{UNNotificationRequest}.
         """
 
 
@@ -208,7 +215,19 @@ class Notifier[NotifT]:
     async def notifyAt(
         self, when: DateTime[ZoneInfo], notification: NotifT, title: str, body: str
     ) -> None:
+
         components: NSDateComponents = NSDateComponents.alloc().init()
+        components.setCalendar_(
+            NSCalendar.calendarWithIdentifier_(NSCalendarIdentifierGregorian)
+        )
+        components.setTimeZone_(NSTimeZone.timeZoneWithName_(when.tzinfo.key))
+        components.setYear_(when.year)
+        components.setMonth_(when.month)
+        components.setDay_(when.day)
+        components.setHour_(when.hour)
+        components.setMinute_(when.minute)
+        components.setSecond_(when.second)
+
         repeats: bool = False
         trigger: UNNotificationTrigger = (
             UNCalendarNotificationTrigger.triggerWithDateMatchingComponents_repeats_(

{quickmacapp-2025.4.4 → quickmacapp-2025.4.15}/src/quickmacapp/_quickapp.py

@@ -177,7 +177,7 @@ class QuickApplication(NSApplication):
     """
     QuickMacApp's main application class.
 
-    @ivar keyEquivalentHandler: Set this attribute to a custom L{NSResponder}
+    @ivar keyEquivalentHandler: Set this attribute to a custom C{NSResponder}
         if you want to handle key equivalents outside the responder chain.  (I
         believe this is necessary in some apps because the responder chain can
         be more complicated in LSUIElement apps, but there might be a better

{quickmacapp-2025.4.4 → quickmacapp-2025.4.15}/src/quickmacapp/notifications.py

@@ -12,18 +12,18 @@ from zoneinfo import ZoneInfo
 from datetype import DateTime
 from UserNotifications import (
     UNNotificationCategoryOptionCustomDismissAction as _UNNotificationCategoryOptionCustomDismissAction,
-    UNUserNotificationCenter as _UNUserNotificationCenter,
     UNNotificationDefaultActionIdentifier as _UNNotificationDefaultActionIdentifier,
     UNNotificationDismissActionIdentifier as _UNNotificationDismissActionIdentifier,
 )
+from UserNotifications import UNUserNotificationCenter as _UNUserNotificationCenter
 
 from quickmacapp._notifications import (
     NotificationTranslator,
+    _AppNotificationsCtxBuilder,
     _BuiltinActionInfo,
     _PlainNotificationActionInfo,
     _setActionInfo,
     _TextNotificationActionInfo,
-    _AppNotificationsCtxBuilder,
 )
 
 __all__ = [
@@ -139,6 +139,9 @@ class Notifier[NotifT](Protocol):
 
 
 class NotificationConfig(Protocol):
+    """
+    The application-wide configuration for a notification.
+    """
 
     def add[NotifT](
         self,
@@ -147,7 +150,35 @@ class NotificationConfig(Protocol):
         allowInCarPlay: bool = False,
         hiddenPreviewsShowTitle: bool = False,
         hiddenPreviewsShowSubtitle: bool = False,
-    ) -> Notifier[NotifT]: ...
+    ) -> Notifier[NotifT]:
+        """
+        Add a new category (represented by a plain Python class, which may have
+        some methods that were decorated with L{response}C{(...)},
+        L{response.text}C{(...)}).
+
+        @param category: A Python type that contains the internal state for the
+            notifications that will be emitted, that will be relayed back to
+            its responses (e.g. the response methods on the category).
+
+        @param translator: a translator that can serialize and deserialize
+            python objects to C{UNUserNotificationCenter} values.
+
+        @param allowInCarPlay: Should the notification be allowed to show in
+            CarPlay?
+
+        @param hiddenPreviewsShowTitle: Should lock-screen previews for this
+            notification show the unredacted title?
+
+        @param hiddenPreviewsShowSubtitle: Should lock-screen previews for this
+            notification show the unredacted subtitle?
+
+        @return: A L{Notifier} that can deliver notifications to macOS.
+
+        @note: This method can I{only} be called within the C{with} statement
+            for the context manager beneath C{configureNotifications}, and can
+            only do this once per process.  Otherwise it will raise an
+            exception.
+        """
 
 
 def configureNotifications() -> _AbstractAsyncContextManager[NotificationConfig]:
@@ -208,7 +239,7 @@ def configureNotifications() -> _AbstractAsyncContextManager[NotificationConfig]
     uselessness, and in this oversimplified case, it is!  However, if you are
     sending notifications to a user, you really need to be able to I{respond}
     to notifications from a user, and that's where your notification data class
-    as well as L{responder} comes in.  To respond to a notification when the
+    as well as L{response} comes in.  To respond to a notification when the
     user clicks on it, you can add a method like so::
 
         class MyNotificationData:
@@ -226,7 +257,7 @@ def configureNotifications() -> _AbstractAsyncContextManager[NotificationConfig]
     be serialized and deserialized with C{MyNotificationLoader.toNotification}
     (converting your Python class into a macOS notification, to send along to
     the OS) and C{MyNotificationLoader.fromNotification} (converting the data
-    sent along with the user's response back into a L{MyNotificationData}).
+    sent along with the user's response back into a C{MyNotificationData}).
 
     @note: If your app schedules a notification, then quits, when the user
         responds (clicks on it, uses a button, dismisses it, etc) then the OS

{quickmacapp-2025.4.4 → quickmacapp-2025.4.15}/src/quickmacapp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quickmacapp
-Version: 2025.4.4
+Version: 2025.4.15
 Summary: Make it easier to write Mac apps in Python
 Description-Content-Type: text/x-rst
 License-File: LICENSE