quickmacapp 2025.7.22__py3-none-any.whl → 2026.2.3__py3-none-any.whl

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/_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.7.22.dist-info → quickmacapp-2026.2.3.dist-info}/METADATA

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

quickmacapp-2026.2.3.dist-info/RECORD

@@ -0,0 +1,12 @@
+quickmacapp/__init__.py,sha256=jmUN0AXWo6UtzitqPrGOudBwHIP1JuXlQ0e30VUCgkY,403
+quickmacapp/_background.py,sha256=uRyYqnRQnVs2Thc-tXVjJjrMdk98KRSaXmmSUMpBdq4,6834
+quickmacapp/_interactions.py,sha256=eLv_mVf5Jr-puNizlR8tDL_DlLy1Rc82XQ80o0GP5R4,3439
+quickmacapp/_notifications.py,sha256=DNm4-vOF0wQNUUTBHqp3-RKXVQK98ef53isxwsWqyj8,16965
+quickmacapp/_quickapp.py,sha256=VmX8mc9bfmWJtNSH2Jd63ZgZDQIhyyNTq4vXO7vUzXw,9646
+quickmacapp/notifications.py,sha256=UCigVIurf-zWAqVXUYjTtz_xMjcoI23dqyJ4OzZurQM,10275
+quickmacapp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+quickmacapp-2026.2.3.dist-info/licenses/LICENSE,sha256=7RIBNNvrnKHR3lw9z3KXv3Q6RRjhyxtNQoMnoUsf3_M,1091
+quickmacapp-2026.2.3.dist-info/METADATA,sha256=A5EyARrKOaOP4MqKRZZaIqo0HZg962Qx0_zZY2uXJaA,1343
+quickmacapp-2026.2.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+quickmacapp-2026.2.3.dist-info/top_level.txt,sha256=_iJkekUYnuWhCZbFSQyo2d5_6B7OoPwx7k527bokzeA,12
+quickmacapp-2026.2.3.dist-info/RECORD,,

{quickmacapp-2025.7.22.dist-info → quickmacapp-2026.2.3.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

quickmacapp-2025.7.22.dist-info/RECORD

@@ -1,12 +0,0 @@
-quickmacapp/__init__.py,sha256=WAfaenkgALceVKrSmVBoEOJER-SX65r4WjkaBGtmO24,363
-quickmacapp/_background.py,sha256=M_ob3EF8v-Z_gpKuFDl2N9XrQz0eBLFfUp2XErDB3DU,5943
-quickmacapp/_interactions.py,sha256=eLv_mVf5Jr-puNizlR8tDL_DlLy1Rc82XQ80o0GP5R4,3439
-quickmacapp/_notifications.py,sha256=DNm4-vOF0wQNUUTBHqp3-RKXVQK98ef53isxwsWqyj8,16965
-quickmacapp/_quickapp.py,sha256=VmX8mc9bfmWJtNSH2Jd63ZgZDQIhyyNTq4vXO7vUzXw,9646
-quickmacapp/notifications.py,sha256=UCigVIurf-zWAqVXUYjTtz_xMjcoI23dqyJ4OzZurQM,10275
-quickmacapp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-quickmacapp-2025.7.22.dist-info/licenses/LICENSE,sha256=7RIBNNvrnKHR3lw9z3KXv3Q6RRjhyxtNQoMnoUsf3_M,1091
-quickmacapp-2025.7.22.dist-info/METADATA,sha256=BNFvXnBhcDTHceZUL3KESVIVjCfqF-iHeBhluSVt9NU,1344
-quickmacapp-2025.7.22.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-quickmacapp-2025.7.22.dist-info/top_level.txt,sha256=_iJkekUYnuWhCZbFSQyo2d5_6B7OoPwx7k527bokzeA,12
-quickmacapp-2025.7.22.dist-info/RECORD,,