python-dispatch 0.2.2__tar.gz → 0.2.3__tar.gz

{python-dispatch-0.2.2/python_dispatch.egg-info → python_dispatch-0.2.3}/PKG-INFO

@@ -1,38 +1,38 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: python-dispatch
-Version: 0.2.2
-Summary: Lightweight Event Handling
-Home-page: https://github.com/nocarryr/python-dispatch
+Version: 0.2.3
+Summary: Lightweight Event Handling Library for Python
+Keywords: event,properties,dispatch
 Author: Matthew Reid
-Author-email: matt@nomadic-recording.com
-License: MIT
-Project-URL: Documentation, https://python-dispatch.readthedocs.io
-Project-URL: Source, https://github.com/nocarryr/python-dispatch
-Project-URL: Tracker, https://github.com/nocarryr/python-dispatch/issues
-Keywords: event properties dispatch
-Platform: any
+Author-email: Matthew Reid <matt@nomadic-recording.com>
+License-Expression: MIT
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Topic :: Software Development
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 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: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: importlib-metadata ; python_full_version < '3.8'
+Requires-Python: >=3.8
+Project-URL: Documentation, https://python-dispatch.readthedocs.io/
+Project-URL: Download, https://pypi.org/project/python-dispatch/
+Project-URL: Source, https://github.com/nocarryr/python-dispatch
+Project-URL: Tracker, https://github.com/nocarryr/python-dispatch/issues
 Description-Content-Type: text/markdown
-License-File: LICENSE.txt
 
 # python-dispatch
 Lightweight event handling for Python
 
-[![Build Status](https://travis-ci.org/nocarryr/python-dispatch.svg?branch=master)](https://travis-ci.org/nocarryr/python-dispatch)[![Coverage Status](https://coveralls.io/repos/github/nocarryr/python-dispatch/badge.svg?branch=master)](https://coveralls.io/github/nocarryr/python-dispatch?branch=master)[![PyPI version](https://badge.fury.io/py/python-dispatch.svg)](https://badge.fury.io/py/python-dispatch)[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/nocarryr/python-dispatch/master/LICENSE.txt)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/nocarryr/python-dispatch/ci.yml)[![Coverage Status](https://coveralls.io/repos/github/nocarryr/python-dispatch/badge.svg?branch=master)](https://coveralls.io/github/nocarryr/python-dispatch?branch=master)[![PyPI version](https://badge.fury.io/py/python-dispatch.svg)](https://badge.fury.io/py/python-dispatch)[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/nocarryr/python-dispatch/master/LICENSE.txt)
 
 ## Description
 This is an implementation of the "Observer Pattern" with inspiration from the

{python-dispatch-0.2.2 → python_dispatch-0.2.3}/README.md

@@ -1,7 +1,7 @@
 # python-dispatch
 Lightweight event handling for Python
 
-[![Build Status](https://travis-ci.org/nocarryr/python-dispatch.svg?branch=master)](https://travis-ci.org/nocarryr/python-dispatch)[![Coverage Status](https://coveralls.io/repos/github/nocarryr/python-dispatch/badge.svg?branch=master)](https://coveralls.io/github/nocarryr/python-dispatch?branch=master)[![PyPI version](https://badge.fury.io/py/python-dispatch.svg)](https://badge.fury.io/py/python-dispatch)[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/nocarryr/python-dispatch/master/LICENSE.txt)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/nocarryr/python-dispatch/ci.yml)[![Coverage Status](https://coveralls.io/repos/github/nocarryr/python-dispatch/badge.svg?branch=master)](https://coveralls.io/github/nocarryr/python-dispatch?branch=master)[![PyPI version](https://badge.fury.io/py/python-dispatch.svg)](https://badge.fury.io/py/python-dispatch)[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/nocarryr/python-dispatch/master/LICENSE.txt)
 
 ## Description
 This is an implementation of the "Observer Pattern" with inspiration from the

{python-dispatch-0.2.2 → python_dispatch-0.2.3}/pydispatch/aioutils.py

@@ -1,13 +1,25 @@
+import sys
 import asyncio
 import threading
-from _weakref import ref
-from _weakrefset import _IterationGuard
+from weakref import ref
+from _weakref import _remove_dead_weakref # type: ignore[import]
+if sys.version_info < (3, 14):
+    from _weakrefset import _IterationGuard
+else:
+    # _IterationGuard was removed in Python 3.14. We define a no-op version here
+    class _IterationGuard:
+        def __init__(self, obj):
+            pass
+        def __enter__(self):
+            pass
+        def __exit__(self, *args):
+            pass
+
 
 from pydispatch.utils import (
     WeakMethodContainer,
     isfunction,
     get_method_vars,
-    _remove_dead_weakref,
 )
 
 
@@ -192,6 +204,12 @@ class AioWeakMethodContainer(WeakMethodContainer):
                     _remove_dead_weakref(self.data, wr.key)
                     self._on_weakref_fin(wr.key)
         self._remove = remove
+
+        # `_pending_removals` and `_iterating` were removed in Python 3.14.
+        # To maintain compatibility with earlier versions, we reintroduce them here.
+        self._pending_removals = []
+        self._iterating = set()
+
         self.event_loop_map = {}
     def add_method(self, loop, callback):
         """Add a coroutine function

{python-dispatch-0.2.2 → python_dispatch-0.2.3}/pydispatch/dispatch.py

@@ -209,14 +209,16 @@ class Dispatcher(object):
             ...     async def on_foo_test_event(self, *args, **kwargs):
             ...         self.got_foo_event.set()
 
-            >>> loop = asyncio.get_event_loop()
-            >>> foo = Foo()
-            >>> bar = Bar()
-            >>> foo.bind(test_event=bar.on_foo_test_event, __aio_loop__=loop)
-            >>> fut = asyncio.ensure_future(bar.wait_for_foo())
-
-            >>> foo.emit('test_event')
-            >>> loop.run_until_complete(fut)
+            >>> async def main():
+            ...     loop = asyncio.get_running_loop()
+            ...     foo = Foo()
+            ...     bar = Bar()
+            ...     foo.bind(test_event=bar.on_foo_test_event, __aio_loop__=loop)
+            ...     fut = asyncio.create_task(bar.wait_for_foo())
+            ...     foo.emit('test_event')
+            ...     await fut
+
+            >>> asyncio.run(main())
             got foo!
 
             This can also be done using :meth:`bind_async`.

{python-dispatch-0.2.2 → python_dispatch-0.2.3}/pydispatch/utils.py

@@ -1,6 +1,6 @@
 import weakref
-from weakref import ref, _remove_dead_weakref
-from _weakref import ref
+from weakref import ref
+from _weakref import _remove_dead_weakref # type: ignore[import]
 import types
 import asyncio
 
@@ -114,6 +114,12 @@ class InformativeWVDict(weakref.WeakValueDictionary):
                     _remove_dead_weakref(self.data, wr.key)
                     self._data_del_callback(wr.key)
         self._remove = remove
+
+        # `_pending_removals` and `_iterating` were removed in Python 3.14.
+        # To maintain compatibility with earlier versions, we reintroduce them here.
+        self._pending_removals = []
+        self._iterating = set()
+
         self.data = InformativeDict()
         self.data.del_callback = self._data_del_callback
     def _data_del_callback(self, key):

python_dispatch-0.2.3/pyproject.toml

@@ -0,0 +1,84 @@
+
+[project]
+name = "python-dispatch"
+version = "0.2.3"
+description = "Lightweight Event Handling Library for Python"
+authors = [
+    { name = "Matthew Reid", email = "matt@nomadic-recording.com" }
+]
+readme = "README.md"
+license = "MIT"
+keywords = ["event", "properties", "dispatch"]
+requires-python = ">=3.8"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Topic :: Software Development",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+dependencies = [
+    "importlib-metadata; python_version < '3.8'"
+]
+
+
+[project.urls]
+Documentation = "https://python-dispatch.readthedocs.io/"
+Source = "https://github.com/nocarryr/python-dispatch"
+Download = "https://pypi.org/project/python-dispatch/"
+Tracker = "https://github.com/nocarryr/python-dispatch/issues"
+
+
+[build-system]
+requires = ["uv_build>=0.9.16,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = ""
+module-name = "pydispatch"
+
+[tool.uv.sources]
+python-dispatch-sphinx = { path = "sphinx-plugin", package = false }
+
+
+[tool.pytest.ini_options]
+testpaths = ["tests", "doc", "pydispatch"]
+addopts = "--doctest-modules --doctest-glob='*.rst' --doctest-glob='*.md'"
+doctest_plus = "enabled"
+asyncio_mode = "auto"
+
+
+[dependency-groups]
+doc = [
+    "furo>=2022.4.7",
+    "m2r2>=0.3.2",
+    "setuptools>=60.2.0",
+    "sphinx<5.0.0",
+    "sphinx-panels>=0.6.0",
+    "sphinx-rst-builder>=0.0.3",
+    "sphinx-rtd-theme>=1.3.0",
+]
+test = [
+    {include-group = "doc"},
+    "coveralls>=3.3.1",
+    "pytest>=7.0.1",
+    "pytest-asyncio>=0.16.0",
+    "pytest-cov>=4.0.0",
+    "pytest-doctestplus>=0.9.0",
+    "tomli; python_version < '3.11'",
+]
+
+dev = [
+    {include-group = "test"},
+    "python-dispatch-sphinx",
+]

python-dispatch-0.2.2/LICENSE.txt

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2016 Matthew Reid
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

python-dispatch-0.2.2/MANIFEST.in

@@ -1,2 +0,0 @@
-include LICENSE*
-include README*

python-dispatch-0.2.2/PKG-INFO

@@ -1,157 +0,0 @@
-Metadata-Version: 2.1
-Name: python-dispatch
-Version: 0.2.2
-Summary: Lightweight Event Handling
-Home-page: https://github.com/nocarryr/python-dispatch
-Author: Matthew Reid
-Author-email: matt@nomadic-recording.com
-License: MIT
-Project-URL: Documentation, https://python-dispatch.readthedocs.io
-Project-URL: Source, https://github.com/nocarryr/python-dispatch
-Project-URL: Tracker, https://github.com/nocarryr/python-dispatch/issues
-Keywords: event properties dispatch
-Platform: any
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Topic :: Software Development
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-
-# python-dispatch
-Lightweight event handling for Python
-
-[![Build Status](https://travis-ci.org/nocarryr/python-dispatch.svg?branch=master)](https://travis-ci.org/nocarryr/python-dispatch)[![Coverage Status](https://coveralls.io/repos/github/nocarryr/python-dispatch/badge.svg?branch=master)](https://coveralls.io/github/nocarryr/python-dispatch?branch=master)[![PyPI version](https://badge.fury.io/py/python-dispatch.svg)](https://badge.fury.io/py/python-dispatch)[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/nocarryr/python-dispatch/master/LICENSE.txt)
-
-## Description
-This is an implementation of the "Observer Pattern" with inspiration from the
-[Kivy](kivy.org) framework. Many of the features though are intentionally
-stripped down and more generalized. The goal is to have a simple drop-in
-library with no dependencies that stays out of the programmer's way.
-
-## Installation
-"python-dispatch" is available on [PyPI](https://pypi.org/project/python-dispatch/)
-and can be installed using pip:
-
-```bash
-pip install python-dispatch
-```
-
-### Python Requirements
-After version `0.1` of this project, only Python 3.6 and above will be supported.
-If using an older Python version, the older releases should still be available
-on PyPI and the correct package should be chosen automatically by `pip`.
-If not, either upgrade `pip` and `setuptools`:
-
-```bash
-pip install -U pip setuptools
-```
-
-Or specify the version manually:
-
-```bash
-pip install python-dispatch<0.2
-```
-
-## Links
-
-|               |                                              |
-| -------------:|:-------------------------------------------- |
-| Project Home  | https://github.com/nocarryr/python-dispatch  |
-| PyPI          | https://pypi.python.org/pypi/python-dispatch |
-| Documentation | https://python-dispatch.readthedocs.io       |
-
-
-## Usage
-
-### Events
-
-```python
->>> from pydispatch import Dispatcher
-
->>> class MyEmitter(Dispatcher):
-...     # Events are defined in classes and subclasses with the '_events_' attribute
-...     _events_ = ['on_state', 'new_data']
-...     def do_some_stuff(self):
-...         # do stuff that makes new data
-...         data = {'foo':'bar'}
-...         # Then emit the change with optional positional and keyword arguments
-...         self.emit('new_data', data=data)
-
->>> # An observer - could inherit from Dispatcher or any other class
->>> class MyListener(object):
-...     def on_new_data(self, *args, **kwargs):
-...         data = kwargs.get('data')
-...         print('I got data: {}'.format(data))
-...     def on_emitter_state(self, *args, **kwargs):
-...         print('emitter state changed')
-
->>> emitter = MyEmitter()
->>> listener = MyListener()
-
->>> # Bind to the "on_state" and "new_data" events of emitter
->>> emitter.bind(on_state=listener.on_emitter_state)
->>> emitter.bind(new_data=listener.on_new_data)
-
->>> emitter.do_some_stuff()
-I got data: {'foo': 'bar'}
->>> emitter.emit('on_state')
-emitter state changed
-
-```
-
-### Properties
-
-```python
->>> from pydispatch import Dispatcher, Property
-
->>> class MyEmitter(Dispatcher):
-...     # Property objects are defined and named at the class level.
-...     # They will become instance attributes that will emit events when their values change
-...     name = Property()
-...     value = Property()
-
->>> class MyListener(object):
-...     def on_name(self, instance, value, **kwargs):
-...         print('emitter name is {}'.format(value))
-...     def on_value(self, instance, value, **kwargs):
-...         print('emitter value is {}'.format(value))
-
->>> emitter = MyEmitter()
->>> listener = MyListener()
-
->>> # Bind to the "name" and "value" properties of emitter
->>> emitter.bind(name=listener.on_name, value=listener.on_value)
-
->>> # Set emitter.name property (triggering the on_name callback)
->>> emitter.name = 'foo'
-emitter name is foo
-
->>> # Set emitter.value (triggering the on_value callback)
->>> emitter.value = 42
-emitter value is 42
-
-```
-
-## Contributing
-
-Contributions are welcome!
-
-If you want to contribute through code or documentation, please see the
-[Contributing Guide](CONTRIBUTING.md) for information.
-
-## License
-
-This project is released under the MIT License. See the [LICENSE](LICENSE.txt) file
-for more information.

python-dispatch-0.2.2/python_dispatch.egg-info/SOURCES.txt

@@ -1,22 +0,0 @@
-LICENSE.txt
-MANIFEST.in
-README.md
-setup.cfg
-setup.py
-pydispatch/__init__.py
-pydispatch/aioutils.py
-pydispatch/decorators.py
-pydispatch/dispatch.py
-pydispatch/properties.py
-pydispatch/utils.py
-python_dispatch.egg-info/PKG-INFO
-python_dispatch.egg-info/SOURCES.txt
-python_dispatch.egg-info/dependency_links.txt
-python_dispatch.egg-info/top_level.txt
-tests/test_aio_listeners.py
-tests/test_aio_lock.py
-tests/test_events.py
-tests/test_global_dispatcher.py
-tests/test_properties.py
-tests/test_subclass_init.py
-tests/test_version_attribute.py

python-dispatch-0.2.2/python_dispatch.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

python-dispatch-0.2.2/python_dispatch.egg-info/top_level.txt

@@ -1 +0,0 @@
-pydispatch

python-dispatch-0.2.2/setup.cfg

@@ -1,56 +0,0 @@
-[metadata]
-name = python-dispatch
-version = 0.2.2
-author = Matthew Reid
-author_email = matt@nomadic-recording.com
-url = https://github.com/nocarryr/python-dispatch
-project_urls = 
-	Documentation = https://python-dispatch.readthedocs.io
-	Source = https://github.com/nocarryr/python-dispatch
-	Tracker = https://github.com/nocarryr/python-dispatch/issues
-description = Lightweight Event Handling
-long_description = file: README.md
-long_description_content_type = text/markdown
-license = MIT
-license_file = LICENSE.txt
-keywords = event properties dispatch
-platforms = any
-python_requires = >=3.6
-install_requires = 
-	importlib_metadata;python_version<'3.8'
-classifiers = 
-	Development Status :: 3 - Alpha
-	Intended Audience :: Developers
-	License :: OSI Approved :: MIT License
-	Operating System :: OS Independent
-	Programming Language :: Python
-	Topic :: Software Development
-	Programming Language :: Python :: 3
-	Programming Language :: Python :: 3.6
-	Programming Language :: Python :: 3.7
-	Programming Language :: Python :: 3.8
-	Programming Language :: Python :: 3.9
-	Programming Language :: Python :: 3.10
-	Programming Language :: Python :: 3.11
-	Topic :: Software Development :: Libraries
-	Topic :: Software Development :: Libraries :: Python Modules
-
-[options]
-packages = find:
-
-[options.packages.find]
-exclude = tests
-
-[options.package_data]
-* = LICENSE*, README*
-
-[tool:pytest]
-testpaths = tests doc pydispatch
-addopts = --doctest-modules --doctest-glob="*.rst" --doctest-glob="*.md"
-doctest_plus = enabled
-asyncio_mode = auto
-
-[egg_info]
-tag_build = 
-tag_date = 0
-

python-dispatch-0.2.2/setup.py

@@ -1,4 +0,0 @@
-import sys
-from setuptools import setup, find_packages
-
-setup()