PyDispatcher 2.0.7__tar.gz → 2.0.9a1__tar.gz

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: PyDispatcher
-Version: 2.0.7
+Version: 2.0.9a1
 Summary: Multi-producer multi-consumer in-memory signal dispatch system
 Home-page: https://github.com/mcfletch/pydispatcher
 Download-URL: https://pypi.org/project/pydispatcher/
@@ -11,13 +11,20 @@ License: BSD
 Keywords: dispatcher,dispatch,pydispatch,event,signal,sender,receiver,propagate,multi-consumer,multi-producer,saferef,robustapply,apply
 Platform: Any
 Classifier: License :: OSI Approved :: BSD License
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 2
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Provides-Extra: dev
+Requires-Dist: tox; extra == "dev"
+Dynamic: download-url
 
 # PyDispatcher Multi-producer Multi-consumer Observables
 
@@ -61,3 +68,22 @@ dispatcher.connect(callback, sender=MyNode, signal=metaKey)
 dispatcher.send(metaKey, MyNode, event=event)
 ```
 
+
+## Scaling
+
+Two structures keep dispatch cost proportional to the work a signal actually
+implies rather than to the size of the program around it.
+
+**Wiring many receivers to one sender.** `connect()` guards against registering
+the same receiver twice for a `(sender, signal)` pair. An index of what is
+already registered answers that in constant time, so wiring N receivers to a
+shared sender costs O(N) rather than O(N²). The index is an optimisation hint:
+every real registration records itself there, so "not registered" is always
+trustworthy, and a stale "registered" costs one scan and nothing else.
+
+**Calling a receiver.** `robustApply` passes a receiver only the arguments it
+will accept, which means knowing its parameters. Those come from the receiver's
+code object, which never changes, so they are derived once and reused --
+`robustapply.SIGNATURE_CACHE_SIZE` bounds how many are remembered. A call with
+no keyword arguments needs no signature at all, since there is nothing to
+subset.

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/PyDispatcher.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: PyDispatcher
-Version: 2.0.7
+Version: 2.0.9a1
 Summary: Multi-producer multi-consumer in-memory signal dispatch system
 Home-page: https://github.com/mcfletch/pydispatcher
 Download-URL: https://pypi.org/project/pydispatcher/
@@ -11,13 +11,20 @@ License: BSD
 Keywords: dispatcher,dispatch,pydispatch,event,signal,sender,receiver,propagate,multi-consumer,multi-producer,saferef,robustapply,apply
 Platform: Any
 Classifier: License :: OSI Approved :: BSD License
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 2
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Provides-Extra: dev
+Requires-Dist: tox; extra == "dev"
+Dynamic: download-url
 
 # PyDispatcher Multi-producer Multi-consumer Observables
 
@@ -61,3 +68,22 @@ dispatcher.connect(callback, sender=MyNode, signal=metaKey)
 dispatcher.send(metaKey, MyNode, event=event)
 ```
 
+
+## Scaling
+
+Two structures keep dispatch cost proportional to the work a signal actually
+implies rather than to the size of the program around it.
+
+**Wiring many receivers to one sender.** `connect()` guards against registering
+the same receiver twice for a `(sender, signal)` pair. An index of what is
+already registered answers that in constant time, so wiring N receivers to a
+shared sender costs O(N) rather than O(N²). The index is an optimisation hint:
+every real registration records itself there, so "not registered" is always
+trustworthy, and a stale "registered" costs one scan and nothing else.
+
+**Calling a receiver.** `robustApply` passes a receiver only the arguments it
+will accept, which means knowing its parameters. Those come from the receiver's
+code object, which never changes, so they are derived once and reused --
+`robustapply.SIGNATURE_CACHE_SIZE` bounds how many are remembered. A call with
+no keyword arguments needs no signature at all, since there is nothing to
+subset.

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/PyDispatcher.egg-info/SOURCES.txt

@@ -31,11 +31,14 @@ examples/simple_sample.py
 pydispatch/__init__.py
 pydispatch/dispatcher.py
 pydispatch/errors.py
+pydispatch/py.typed
 pydispatch/robust.py
 pydispatch/robustapply.py
 pydispatch/saferef.py
 tests/__init__.py
+tests/conftest.py
 tests/test_dispatcher.py
 tests/test_packaging.py
 tests/test_robustapply.py
+tests/test_robustapply_py3_8.py
 tests/test_saferef.py

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/README.md

@@ -40,3 +40,22 @@ dispatcher.connect(callback, sender=MyNode, signal=metaKey)
 dispatcher.send(metaKey, MyNode, event=event)
 ```
 
+
+## Scaling
+
+Two structures keep dispatch cost proportional to the work a signal actually
+implies rather than to the size of the program around it.
+
+**Wiring many receivers to one sender.** `connect()` guards against registering
+the same receiver twice for a `(sender, signal)` pair. An index of what is
+already registered answers that in constant time, so wiring N receivers to a
+shared sender costs O(N) rather than O(N²). The index is an optimisation hint:
+every real registration records itself there, so "not registered" is always
+trustworthy, and a stale "registered" costs one scan and nothing else.
+
+**Calling a receiver.** `robustApply` passes a receiver only the arguments it
+will accept, which means knowing its parameters. Those come from the receiver's
+code object, which never changes, so they are derived once and reused --
+`robustapply.SIGNATURE_CACHE_SIZE` bounds how many are remembered. A call with
+no keyword arguments needs no signature at all, since there is nothing to
+subset.

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/docs/index.html

@@ -212,6 +212,16 @@ objects.
 <h2>Release Notes</h2>
 
 <ul>
+  <li>Version 2.0.8
+    <ul>
+      <li>Python3.8 positional-only and keyword-only robustapply fixes (allows use of keyword only arguments in handlers)</li>
+      <li>Prevent the passing of keywords that match positional-only parameters, or the varargs or varnames parameter names. Note that this is only enforced if there is no varnames.</li>
+    </ul>
+  </li>
+  <li>Version 2.0.7
+    <ul>
+    </ul>
+  </li>
   <li>Version 2.0.6
   <ul>
     <li>Packaging fixes, updates to documentation and metadata.</li>

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/docs/pydoc/__init__.py

@@ -4,4 +4,4 @@ This package is based on the standard pydoc package,
 with a few minor enhancements, and a slightly modified
 format.  An automatic mechanism for generating extensive
 documentation for the OpenGLContext project is provided.
-"""
+"""

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/docs/pydoc/builddocs.py

@@ -16,11 +16,10 @@ if __name__ == "__main__":
     modules = [
         "pydispatch",
         "weakref",
-    ]	
+    ]
     pydoc2.PackageDocumentationGenerator(
         baseModules = modules,
         destinationDirectory = ".",
         exclusions = excludes,
         recursionStops = stops,
     ).process ()
-    

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/docs/pydoc/pydispatch.__init__.html

@@ -6,7 +6,7 @@
 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
 <tr bgcolor="#7799ee">
 <td valign=bottom>&nbsp;<br>
-<font color="#ffffff" face="helvetica, arial">&nbsp;<br><big><big><strong><a href="pydispatch.html"><font color="#ffffff">pydispatch</font></a>.__init__</strong></big></big> (version 2.0.6)</font></td
+<font color="#ffffff" face="helvetica, arial">&nbsp;<br><big><big><strong><a href="pydispatch.html"><font color="#ffffff">pydispatch</font></a>.__init__</strong></big></big> (version 2.0.8)</font></td
 ><td align=right valign=bottom
 ><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/__init__.py">/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/__init__.py</a></font></td></tr></table>
     <p><tt>Multi-consumer&nbsp;multi-producer&nbsp;dispatching&nbsp;mechanism</tt></p>
@@ -20,12 +20,13 @@
 <td width="100%"><strong>__author__</strong> = "Patrick K. O'Brien"<br>
 <strong>__cached__</strong> = '/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/__pycache__/__init__.cpython-310.pyc'<br>
 <strong>__file__</strong> = '/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/__init__.py'<br>
-<strong>__license__</strong> = 'BSD-style, see license.txt for details'<br>
+<strong>__license__</strong> = 'BSD'<br>
 <strong>__loader__</strong> = &lt;_frozen_importlib_external.SourceFileLoader object&gt;<br>
+<strong>__maintainer__</strong> = 'Mike C. Fletcher'<br>
 <strong>__name__</strong> = 'pydispatch.__init__'<br>
 <strong>__package__</strong> = 'pydispatch'<br>
 <strong>__spec__</strong> = ModuleSpec(name='pydispatch.__init__', loader=&lt;_.../OpenGL-dev/pydispatcher/pydispatch/__init__.py')<br>
-<strong>__version__</strong> = '2.0.6'</td></tr></table><p>
+<strong>__version__</strong> = '2.0.8'</td></tr></table><p>
 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
 <tr bgcolor="#7799ee">
 <td colspan=3 valign=bottom>&nbsp;<br>

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/docs/pydoc/pydispatch.html

@@ -6,7 +6,7 @@
 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
 <tr bgcolor="#7799ee">
 <td valign=bottom>&nbsp;<br>
-<font color="#ffffff" face="helvetica, arial">&nbsp;<br><big><big><strong>pydispatch</strong></big></big> (version 2.0.6)</font></td
+<font color="#ffffff" face="helvetica, arial">&nbsp;<br><big><big><strong>pydispatch</strong></big></big> (version 2.0.8)</font></td
 ><td align=right valign=bottom
 ><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/__init__.py">/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/__init__.py</a></font></td></tr></table>
     <p><tt>Multi-consumer&nbsp;multi-producer&nbsp;dispatching&nbsp;mechanism</tt></p>
@@ -27,13 +27,14 @@
 <td width="100%"><strong>__author__</strong> = "Patrick K. O'Brien"<br>
 <strong>__cached__</strong> = '/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/__pycache__/__init__.cpython-310.pyc'<br>
 <strong>__file__</strong> = '/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/__init__.py'<br>
-<strong>__license__</strong> = 'BSD-style, see license.txt for details'<br>
+<strong>__license__</strong> = 'BSD'<br>
 <strong>__loader__</strong> = &lt;_frozen_importlib_external.SourceFileLoader object&gt;<br>
+<strong>__maintainer__</strong> = 'Mike C. Fletcher'<br>
 <strong>__name__</strong> = 'pydispatch'<br>
 <strong>__package__</strong> = 'pydispatch'<br>
 <strong>__path__</strong> = ['/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch']<br>
 <strong>__spec__</strong> = ModuleSpec(name='pydispatch', loader=&lt;_frozen_im...me/mcfletch/OpenGL-dev/pydispatcher/pydispatch'])<br>
-<strong>__version__</strong> = '2.0.6'</td></tr></table><p>
+<strong>__version__</strong> = '2.0.8'</td></tr></table><p>
 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
 <tr bgcolor="#7799ee">
 <td colspan=3 valign=bottom>&nbsp;<br>

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/docs/pydoc/pydispatch.robustapply.html

@@ -36,7 +36,11 @@ returns&nbsp;(function_or_method,&nbsp;codeObject,&nbsp;fromMethod)<br>
 &nbsp;<br>
 If&nbsp;fromMethod&nbsp;is&nbsp;true,&nbsp;then&nbsp;the&nbsp;callable&nbsp;already<br>
 has&nbsp;its&nbsp;first&nbsp;argument&nbsp;bound</tt></dd></dl>
-<dl><dt><a name="-robustApply"><strong>robustApply</strong></a>(receiver, *arguments, **named)</dt><dd><tt>Call&nbsp;receiver&nbsp;with&nbsp;arguments&nbsp;and&nbsp;an&nbsp;appropriate&nbsp;subset&nbsp;of&nbsp;named</tt></dd></dl>
+<dl><dt><a name="-robustApply"><strong>robustApply</strong></a>(receiver, *arguments, **named)</dt><dd><tt>Call&nbsp;receiver&nbsp;with&nbsp;arguments&nbsp;and&nbsp;an&nbsp;appropriate&nbsp;subset&nbsp;of&nbsp;named<br>
+&nbsp;<br>
+The&nbsp;effect&nbsp;of&nbsp;this&nbsp;wrapper&nbsp;is&nbsp;to&nbsp;allow&nbsp;for&nbsp;specifying&nbsp;a&nbsp;large&nbsp;number<br>
+of&nbsp;parameters&nbsp;which&nbsp;may&nbsp;not&nbsp;exist&nbsp;in&nbsp;the&nbsp;final&nbsp;function&nbsp;via&nbsp;named<br>
+parameters,&nbsp;and&nbsp;have&nbsp;those&nbsp;parameters&nbsp;ignored&nbsp;in&nbsp;the&nbsp;final&nbsp;call.</tt></dd></dl>
 </td></tr></table><p>
 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
 <tr bgcolor="#55aa55">
@@ -44,7 +48,9 @@ has&nbsp;its&nbsp;first&nbsp;argument&nbsp;bound</tt></dd></dl>
 <font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
     
 <tr><td bgcolor="#55aa55"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
-<td width="100%"><strong>__cached__</strong> = '/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/__pycache__/robustapply.cpython-310.pyc'<br>
+<td width="100%"><strong>VAR_ARGS</strong> = 4<br>
+<strong>VAR_NAMES</strong> = 8<br>
+<strong>__cached__</strong> = '/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/__pycache__/robustapply.cpython-310.pyc'<br>
 <strong>__file__</strong> = '/home/mcfletch/OpenGL-dev/pydispatcher/pydispatch/robustapply.py'<br>
 <strong>__loader__</strong> = &lt;_frozen_importlib_external.SourceFileLoader object&gt;<br>
 <strong>__name__</strong> = 'pydispatch.robustapply'<br>

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/docs/pydoc/pydoc2.py

@@ -1,10 +1,31 @@
 """Pydoc sub-class for generating documentation for entire packages"""
-import pydoc, inspect, os, string
-import sys, imp, os, stat, re, types, inspect
-from reprlib import Repr
+import pydoc
+import inspect
+import os
+import sys
 
 
 class DefaultFormatter(pydoc.HTMLDoc):
+    def heading(self, *args):
+        try:
+            return super().heading(*args)
+        except TypeError:
+            # Python 3.11 doesn't use the color args
+            args = list(args)
+            del args[1:3]
+            return super().heading(*args)
+
+    def section(self, *args):
+        try:
+            # Python 3.11 uses a class instead of colors
+            py311_args = list(args)
+            del py311_args[1:3]
+            cls = '-'.join(['section', *(args[0].lower().split())])
+            py311_args.insert(1, cls)
+            return super().section(*py311_args)
+        except TypeError:
+            return super().section(*args)
+
     def docmodule(self, object, name=None, mod=None, packageContext=None, *ignored):
         """Produce HTML documentation for a module object."""
         name = object.__name__  # ignore the passed-in name
@@ -155,7 +176,7 @@ class DefaultFormatter(pydoc.HTMLDoc):
                     modpkgs.append((file, object.__name__, 1, 0))
             modpkgs.sort()
             # do more recursion here...
-            for (modname, name, ya, yo) in modpkgs:
+            for (modname, _name, _ya, _yo) in modpkgs:
                 packageContext.addInteresting(".".join((object.__name__, modname)))
             items = []
             for (modname, name, ispackage, isshadowed) in modpkgs:
@@ -178,7 +199,7 @@ class DefaultFormatter(pydoc.HTMLDoc):
                         items.append(
                             self.modpkglink((modname, name, ispackage, isshadowed))
                         )
-                except:
+                except Exception:
                     items.append(
                         self.modpkglink((modname, name, ispackage, isshadowed))
                     )
@@ -242,7 +263,7 @@ class PackageDocumentationGenerator:
         for exclusion in exclusions:
             try:
                 self.exclusions[exclusion] = pydoc.locate(exclusion)
-            except pydoc.ErrorDuringImport as value:
+            except pydoc.ErrorDuringImport:
                 self.warn(
                     """Unable to import the module %s which was specified as an exclusion module"""
                     % (repr(exclusion))
@@ -264,7 +285,7 @@ class PackageDocumentationGenerator:
         try:
             self.baseSpecifiers[specifier] = pydoc.locate(specifier)
             self.pending.append(specifier)
-        except pydoc.ErrorDuringImport as value:
+        except pydoc.ErrorDuringImport:
             self.warn(
                 """Unable to import the module %s which was specified as a base module"""
                 % (repr(specifier))
@@ -368,7 +389,7 @@ class PackageDocumentationGenerator:
     def recurseScan(self, objectList):
         """Process the list of modules trying to add each to the
         list of interesting modules"""
-        for key, value in objectList:
+        for _key, value in objectList:
             self.addInteresting(value.__name__)
 
 

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/docs/pydoc/weakref.html

@@ -884,5 +884,5 @@ reference&nbsp;to&nbsp;the&nbsp;proxy&nbsp;when&nbsp;'<a href="builtins.html#obj
 <strong>__file__</strong> = '/usr/lib/python3.10/weakref.py'<br>
 <strong>__loader__</strong> = &lt;_frozen_importlib_external.SourceFileLoader object&gt;<br>
 <strong>__name__</strong> = 'weakref'<br>
-<strong>__spec__</strong> = ModuleSpec(name='weakref', loader=&lt;_frozen_impor...a55a80&gt;, origin='/usr/lib/python3.10/weakref.py')</td></tr></table>
+<strong>__spec__</strong> = ModuleSpec(name='weakref', loader=&lt;_frozen_impor...fe0e80&gt;, origin='/usr/lib/python3.10/weakref.py')</td></tr></table>
 </body></html>

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/examples/extra_args.py

@@ -21,4 +21,4 @@ def main( ):
     dispatcher.send( signal=SIGNAL2, sender=second_sender, moo='this' )
 
 if __name__ == "__main__":
-    main()
+    main()

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/examples/hello_messages.py

@@ -15,4 +15,4 @@ def main( ):
     dispatcher.send( signal=SIGNAL, sender=second_sender )
 
 if __name__ == "__main__":
-    main()
+    main()

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/examples/simple_sample.py

@@ -75,4 +75,4 @@ if __name__ == "__main__":
         signal = DO_SOMETHING_ELSE,
         sender = ourObjects[0],
         table = "Table Argument",
-    )
+    )

{PyDispatcher-2.0.7 → pydispatcher-2.0.9a1}/pydispatch/__init__.py

@@ -1,5 +1,6 @@
 """Multi-consumer multi-producer dispatching mechanism
 """
-__version__ = "2.0.7"
+__version__ = "2.0.9a1"
 __author__ = "Patrick K. O'Brien"
+__maintainer__ = "Mike C. Fletcher"
 __license__ = "BSD"