pycascadeui 3.12.2__tar.gz → 3.13.0__tar.gz

{pycascadeui-3.12.2/pycascadeui.egg-info → pycascadeui-3.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycascadeui
-Version: 3.12.2
+Version: 3.13.0
 Summary: Redux-inspired UI framework for discord.py
 Author-email: HollowTheSilver <hollow@users.noreply.github.com>
 License-Expression: MIT
@@ -28,8 +28,8 @@ Requires-Dist: discord.py>=2.7
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
-Requires-Dist: black>=26.3; extra == "dev"
-Requires-Dist: isort>=8.0; extra == "dev"
+Requires-Dist: black<27.0,>=26.3; extra == "dev"
+Requires-Dist: isort<9.0,>=8.0; extra == "dev"
 Requires-Dist: testcontainers[postgres]>=4.0; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: mkdocs>=1.5; extra == "docs"

{pycascadeui-3.12.2 → pycascadeui-3.13.0}/cascadeui/__init__.py

@@ -184,7 +184,7 @@ if "PostgresBackend" in _persistence_all:
 # // ========================================( Script )======================================== // #
 
 
-__version__ = "3.12.2"
+__version__ = "3.13.0"
 
 # Export public API
 __all__ = [

{pycascadeui-3.12.2 → pycascadeui-3.13.0}/cascadeui/components/base.py

@@ -13,7 +13,13 @@ from ..state.actions import ActionCreators
 from ..state.store import _CURRENT_INTERACTION
 from ..utils.coercion import coerce_snowflake_match
 from ..utils.hooks import accepts_second_positional, await_maybe, can_accept_positional
-from ..utils.responses import ack_backstop, open_modal_safe, respond_safe, trailing_ack
+from ..utils.responses import (
+    ack_backstop,
+    open_modal_safe,
+    respond_safe,
+    trailing_ack,
+    validate_ack_delay,
+)
 from .types import MAX_SELECT_OPTIONS
 
 logger = logging.getLogger(__name__)
@@ -552,15 +558,11 @@ class DynamicPersistentButton(
         ``DynamicPersistentButton`` itself, because a class's
         ``__init_subclass__`` runs on its subclasses, not on itself.
 
-        Also validates ``auto_defer_delay`` (must be a positive number) at
-        definition time, mirroring ``Modal``.
+        Also validates ``auto_defer_delay`` (a positive number under Discord's
+        3s ack deadline) at definition time, sharing the check ``Modal`` uses.
         """
         super().__init_subclass__(**kwargs)
-        delay = cls.auto_defer_delay
-        if not isinstance(delay, (int, float)) or isinstance(delay, bool) or delay <= 0:
-            raise ValueError(
-                f"{cls.__name__}.auto_defer_delay must be a positive number, got {delay!r}"
-            )
+        validate_ack_delay(cls.__name__, "auto_defer_delay", cls.auto_defer_delay)
         _dynamic_button_classes[f"{cls.__module__}.{cls.__qualname__}"] = cls
 
     @classmethod

{pycascadeui-3.12.2 → pycascadeui-3.13.0}/cascadeui/components/inputs.py

@@ -11,7 +11,7 @@ from discord import CheckboxGroupOption, Interaction, RadioGroupOption, TextStyl
 from discord.ui.select import BaseSelect
 
 from ..utils.hooks import await_maybe
-from ..utils.responses import ack_backstop, respond_safe, trailing_ack
+from ..utils.responses import ack_backstop, respond_safe, trailing_ack, validate_ack_delay
 from ..utils.strings import slugify
 from ..validation import validate_fields
 from .base import StatefulComponent, require_value_callback
@@ -593,19 +593,16 @@ class Modal(discord.ui.Modal, StatefulComponent):
     auto_defer_delay: float = 2.5
 
     def __init_subclass__(cls, **kwargs):
-        """Reject a non-positive ``auto_defer_delay`` at subclass-definition time.
+        """Reject an unusable ``auto_defer_delay`` at subclass-definition time.
 
-        A value at or below zero (or the wrong type) silently defeats the ack
-        backstop, so it fails when the subclass is defined rather than as a
-        dropped interaction at runtime. Mirrors the view side's
-        ``_POSITIVE_NUMBER_ATTRS`` check.
+        A value at or below zero, the wrong type, or one at or past Discord's
+        3s ack deadline silently defeats the ack backstop, so it fails when the
+        subclass is defined rather than as a dropped interaction at runtime.
+        Shares :func:`~cascadeui.utils.responses.validate_ack_delay` with the
+        view side's ``_ACK_DELAY_ATTRS`` check.
         """
         super().__init_subclass__(**kwargs)
-        delay = cls.auto_defer_delay
-        if not isinstance(delay, (int, float)) or isinstance(delay, bool) or delay <= 0:
-            raise ValueError(
-                f"{cls.__name__}.auto_defer_delay must be a positive number, got {delay!r}"
-            )
+        validate_ack_delay(cls.__name__, "auto_defer_delay", cls.auto_defer_delay)
 
     def __init__(
         self,

{pycascadeui-3.12.2 → pycascadeui-3.13.0}/cascadeui/devtools.py

@@ -563,6 +563,11 @@ class InspectorView(TabLayoutView):
 
         # Exit live instances first
         for view_id, view in list(active.items()):
+            # One view's exit cascades to the children attached to it, so a
+            # snapshot taken before the first exit can name a view that is
+            # already gone by the time the loop reaches it.
+            if view._torn_down():
+                continue
             try:
                 await view.exit()
                 exited += 1
@@ -1429,6 +1434,9 @@ class DevToolsCog(commands.Cog, name="cascadeui_devtools"):
         for view_id, view in list(active.items()):
             if gid is not None and getattr(view, "guild_id", None) != gid:
                 continue
+            # A view an earlier exit cascaded to is already gone.
+            if view._torn_down():
+                continue
             try:
                 await view.exit()
                 exited += 1
@@ -1525,6 +1533,9 @@ class DevToolsCog(commands.Cog, name="cascadeui_devtools"):
         # state half-torn-down.
         failed = 0
         for view_id, view in list(store.get_active_views().items()):
+            # A view an earlier exit cascaded to is already gone.
+            if view._torn_down():
+                continue
             try:
                 await view.exit()
             except Exception as exc:
@@ -1535,6 +1546,13 @@ class DevToolsCog(commands.Cog, name="cascadeui_devtools"):
         # added to ``StateStore.__init__`` flow through here automatically.
         store.state = StateStore._build_initial_state()
 
+        # The registry mirror is rebuilt rather than left empty: rows the exit
+        # loop above did not delete are still on disk, and a mirror that has
+        # forgotten them retires nothing when their key is exited later.
+        manager = getattr(store, "persistence_manager", None)
+        if manager is not None:
+            manager.reseed_registry_mirror()
+
         # Observability: invalidate every @computed so cached aggregates
         # recompute against the empty state on next access, and clear the
         # selector memo so subscriber selectors do not short-circuit on
@@ -1669,7 +1687,8 @@ class DevToolsCog(commands.Cog, name="cascadeui_devtools"):
         live panel. The cost is that a channel the bot will never see
         again is re-fetched every startup. This surfaces how long each
         one has been that way, and hands the delete decision to whoever
-        runs the command.
+        runs the command, or to the daily sweep when the middleware sets
+        ``prune_unreachable_after_days``.
         """
         store = get_store()
         manager = getattr(store, "persistence_manager", None)