Merge pull request #145 from pallets-eco/default-namespace

expose the default signal namespace

CHANGES.rst

@@ -11,6 +11,8 @@ Unreleased
     signal and specify that it will be removed in the next version.
 -   Greatly simplify how the library uses weakrefs. This is a significant change
     internally but should not affect any public API. :pr:`144`
+-   Expose the namespace used by ``signal()`` as ``default_namespace``.
+    :pr:`145`
 
 
 Version 1.7.0

src/blinker/__init__.py

@@ -3,6 +3,7 @@
 import typing as t
 
 from .base import ANY
+from .base import default_namespace
 from .base import NamedSignal
 from .base import Namespace
 from .base import Signal
@@ -11,11 +12,12 @@
 
 __all__ = [
     "ANY",
+    "default_namespace",
     "NamedSignal",
     "Namespace",
     "Signal",
-    "WeakNamespace",
     "signal",
+    "WeakNamespace",
 ]
 
 

src/blinker/base.py

@@ -546,7 +546,15 @@ def signal(self, name: str, doc: str | None = None) -> NamedSignal:
             return result  # type: ignore[no-any-return]
 
 
-signal = Namespace().signal
+default_namespace = Namespace()
+"""A default namespace for creating named signals. :func:`signal` creates a
+signal in this namespace.
+"""
+
+signal = default_namespace.signal
+"""Create a named signal in :data:`default_namespace`. Repeated calls with
+the same name will return the same signal.
+"""
 
 
 def __getattr__(name: str) -> t.Any: