quickmacapp 2025.6.24__tar.gz → 2026.2.3__tar.gz

{quickmacapp-2025.6.24 → quickmacapp-2026.2.3}/PKG-INFO

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

{quickmacapp-2025.6.24 → quickmacapp-2026.2.3}/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.06.24"
+version = "2026.02.03"
 dependencies = [
     "pyobjc-framework-Cocoa",
     "pyobjc-framework-ExceptionHandling",

{quickmacapp-2025.6.24 → quickmacapp-2026.2.3}/src/quickmacapp/__init__.py

@@ -1,6 +1,6 @@
 from ._quickapp import Actionable, ItemState, Status, mainpoint, menu, quit
 from ._interactions import ask, choose, answer, getpass
-from ._background import dockIconWhenVisible
+from ._background import dockIconWhenVisible, DockIconManager
 
 __all__ = [
     "Actionable",
@@ -14,4 +14,5 @@ __all__ = [
     "answer",
     "getpass",
     "dockIconWhenVisible",
+    "DockIconManager",
 ]

{quickmacapp-2025.6.24 → quickmacapp-2026.2.3}/src/quickmacapp/_background.py

@@ -1,6 +1,6 @@
-from typing import Any, Callable
-
+from contextlib import contextmanager
 from dataclasses import dataclass, field
+from typing import Any, Callable, Iterator, Protocol, ContextManager
 
 from AppKit import (
     NSApplication,
@@ -21,6 +21,18 @@ from AppKit import (
 )
 
 
+class DockIconManager(Protocol):
+    """
+    Methods for managing the background dock icon status.
+    """
+
+    def noDockIcon(self) -> ContextManager[None]:
+        """
+        Temporarily suppress the application foregrounding with a dock icon,
+        for example, while displaying a brief popup.
+        """
+
+
 @dataclass
 class SometimesBackground:
     """
@@ -35,12 +47,27 @@ class SometimesBackground:
     onSpaceChange: Callable[[], None]
     currentlyRegular: bool = False
     previouslyActiveApp: NSRunningApplication = field(init=False)
+    suppressed: bool = False
+
+    @contextmanager
+    def noDockIcon(self) -> Iterator[None]:
+        """
+        For the duration of this contextmanager, don't show the dock icon or show the main window.
+        """
+        self.suppressed = True
+        try:
+            yield None
+        finally:
+            self.suppressed = False
 
     def someApplicationActivated_(self, notification: Any) -> None:
         # NSLog(f"active {notification} {__file__}")
         whichApp = notification.userInfo()[NSWorkspaceApplicationKey]
 
-        if whichApp == NSRunningApplication.currentApplication():
+        if (
+            whichApp == NSRunningApplication.currentApplication()
+            and not self.suppressed
+        ):
             if self.currentlyRegular:
                 # NSLog("show editor window")
                 self.mainWindow.setIsVisible_(True)
@@ -89,7 +116,9 @@ class SometimesBackground:
                 NSLog("I am not on the active space, closing the window")
                 self.mainWindow.close()
             else:
-                NSLog("I am not on the active space, but that's OK, leaving window open.")
+                NSLog(
+                    "I am not on the active space, but that's OK, leaving window open."
+                )
         else:
             NSLog("I am on the active space; not closing.")
         self.onSpaceChange()
@@ -143,7 +172,7 @@ def dockIconWhenVisible(
     mainWindow: NSWindow,
     hideIconOnOtherSpaces: bool = True,
     onSpaceChange: Callable[[], None] = lambda: None,
-):
+) -> DockIconManager:
     """
     When the given main window is visible, we should have a dock icon (i.e.: be
     NSApplicationActivationPolicyRegular).  When our application is activated,
@@ -152,4 +181,6 @@ def dockIconWhenVisible(
     then closed, or when our application is hidden, we should hide our dock
     icon (i.e.: be NSApplicationActivationPolicyAccessory).
     """
-    SometimesBackground(mainWindow, hideIconOnOtherSpaces, onSpaceChange).startObserving()
+    background = SometimesBackground(mainWindow, hideIconOnOtherSpaces, onSpaceChange)
+    background.startObserving()
+    return background

{quickmacapp-2025.6.24 → quickmacapp-2026.2.3}/src/quickmacapp/_quickapp.py

@@ -56,13 +56,22 @@ class Actionable(NSObject):
     _thunk: Callable[[], object]
     _state: ItemState
 
+    def initWithFunction_(self, thunk: Callable[[], None]) -> Actionable:
+        """
+        Backwards compatibility initializer, creating this L{Actionable} in the
+        default L{ItemState}.
+        """
+        return self.initWithFunction_andState_(thunk, ItemState())
+
     def initWithFunction_andState_(
         self, thunk: Callable[[], None], state: ItemState
     ) -> Actionable:
         """
-        Remember the given callable.
+        Remember the given callable, and the given menu state.
 
         @param thunk: the callable to run in L{doIt_}.
+
+        @param state: the initial state of the menu item presentation
         """
         self._thunk = thunk
         self._state = state

{quickmacapp-2025.6.24 → quickmacapp-2026.2.3}/src/quickmacapp.egg-info/PKG-INFO

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