ezmsg 3.2.2__tar.gz → 3.3.0__tar.gz

{ezmsg-3.2.2/ezmsg.egg-info → ezmsg-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ezmsg
-Version: 3.2.2
+Version: 3.3.0
 Summary: A simple DAG-based computation model
 Home-page: https://github.com/iscoe/ezmsg
 Author: Griffin Milsap
@@ -17,16 +17,17 @@ License-File: LICENSE
 
 Messaging and Multiprocessing.
 
-`ezmsg` is a pure-python implementation of a directed acyclic graph (DAG) pub/sub messaging pattern based on [`labgraph`](https://github.com/facebookresearch/labgraph) which is optimized and intended for use in constructing real-time software.  `ezmsg` implements much of the `labgraph` API (with a few notable differences), and owes a lot of its design to the `labgraph` developers/project.
+`ezmsg` is a pure-Python implementation of a directed acyclic graph (DAG) pub/sub messaging pattern based on [`labgraph`](https://github.com/facebookresearch/labgraph) which is optimized and intended for use in constructing real-time software.  `ezmsg` implements much of the `labgraph` API (with a few notable differences), and owes a lot of its design to the `labgraph` developers/project.
 
-`ezmsg` is very fast and uses Python's (currently) new `multiprocessing.shared_memory` module to facilitate efficient message passing without C++ or any compilation/build tooling.
+`ezmsg` is very fast and uses Python's `multiprocessing.shared_memory` module to facilitate efficient message passing without C++ or any compilation/build tooling.
 
 ## Installation
 `pip install ezmsg`
 
 ## Dependencies
 
-Due to reliance on `multiprocessing.shared_memory`, `ezmsg` requires __minimum Python 3.8__. Beyond that, `ezmsg` is a pure Python library with no external dependencies.
+* Due to reliance on `multiprocessing.shared_memory`, `ezmsg` requires __minimum Python 3.8__.
+* `typing_extensions`
 
 Testing `ezmsg` requires: 
 * `pytest`

{ezmsg-3.2.2 → ezmsg-3.3.0}/README.md

@@ -2,16 +2,17 @@
 
 Messaging and Multiprocessing.
 
-`ezmsg` is a pure-python implementation of a directed acyclic graph (DAG) pub/sub messaging pattern based on [`labgraph`](https://github.com/facebookresearch/labgraph) which is optimized and intended for use in constructing real-time software.  `ezmsg` implements much of the `labgraph` API (with a few notable differences), and owes a lot of its design to the `labgraph` developers/project.
+`ezmsg` is a pure-Python implementation of a directed acyclic graph (DAG) pub/sub messaging pattern based on [`labgraph`](https://github.com/facebookresearch/labgraph) which is optimized and intended for use in constructing real-time software.  `ezmsg` implements much of the `labgraph` API (with a few notable differences), and owes a lot of its design to the `labgraph` developers/project.
 
-`ezmsg` is very fast and uses Python's (currently) new `multiprocessing.shared_memory` module to facilitate efficient message passing without C++ or any compilation/build tooling.
+`ezmsg` is very fast and uses Python's `multiprocessing.shared_memory` module to facilitate efficient message passing without C++ or any compilation/build tooling.
 
 ## Installation
 `pip install ezmsg`
 
 ## Dependencies
 
-Due to reliance on `multiprocessing.shared_memory`, `ezmsg` requires __minimum Python 3.8__. Beyond that, `ezmsg` is a pure Python library with no external dependencies.
+* Due to reliance on `multiprocessing.shared_memory`, `ezmsg` requires __minimum Python 3.8__.
+* `typing_extensions`
 
 Testing `ezmsg` requires: 
 * `pytest`

ezmsg-3.3.0/docs/source/conf.py

@@ -0,0 +1,35 @@
+# Configuration file for the Sphinx documentation builder.
+
+# -- Project information
+
+project = "ezmsg"
+copyright = "2022, JHU/APL"
+author = "JHU/APL"
+
+release = "3.0"
+version = "3.0.0"
+
+# -- General configuration
+
+extensions = [
+    "sphinx.ext.duration",
+    "sphinx.ext.doctest",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+]
+
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3/", None),
+    "sphinx": ("https://www.sphinx-doc.org/en/master/", None),
+}
+intersphinx_disabled_domains = ["std"]
+
+templates_path = ["_templates"]
+
+# -- Options for HTML output
+
+html_theme = "sphinx_rtd_theme"
+
+# -- Options for EPUB output
+epub_show_urls = "footnote"

ezmsg-3.3.0/examples/ezmsg_attach.py

@@ -0,0 +1,8 @@
+import ezmsg.core as ez
+
+from ezmsg.util.debuglog import DebugLog
+
+if __name__ == "__main__":
+    print("This example attaches to the system created/run by ezmsg_toy.py.")
+    log = DebugLog()
+    ez.run(log, connections=(("TestSystem/PING/OUTPUT", log.INPUT),))

{ezmsg-3.2.2 → ezmsg-3.3.0}/examples/ezmsg_configs.py

@@ -1,16 +1,14 @@
 import asyncio
-import logging
 
 import ezmsg.core as ez
-from ezmsg.testing.debuglog import DebugLog
+from ezmsg.util.debuglog import DebugLog
 
 from typing import AsyncGenerator, Optional
 
-logger = logging.getLogger(__name__)
-
 
 # Terminator -- Arnold Schwarzenegger
 
+
 class TerminatorSettings(ez.Settings):
     term_after: float = 1.0  # sec
 
@@ -23,6 +21,7 @@ class Terminator(ez.Unit):
         await asyncio.sleep(self.SETTINGS.term_after)
         raise ez.NormalTermination
 
+
 # Generator -- A Pure Publisher
 
 
@@ -32,7 +31,6 @@ class GeneratorSettings(ez.Settings):
 
 
 class Generator(ez.Unit):
-
     SETTINGS: GeneratorSettings
 
     OUTPUT = ez.OutputStream(int)
@@ -47,12 +45,12 @@ class Generator(ez.Unit):
 
 # Modulus -- A Pure Modifier
 
+
 class ModulusSettings(ez.Settings):
     mod: int = 3
 
 
 class Modulus(ez.Unit):
-
     SETTINGS: ModulusSettings
 
     INPUT = ez.InputStream(int)
@@ -66,6 +64,7 @@ class Modulus(ez.Unit):
 
 # Listener -- A Pure Subscriber
 
+
 class ListenerState(ez.State):
     value: Optional[int] = None
 
@@ -82,56 +81,58 @@ class Listener(ez.Unit):
 
 # Weird passthrough collection
 
+
 class PassthroughCollection(ez.Collection):
     INPUT = ez.InputStream(int)
     OUTPUT = ez.OutputStream(int)
 
     def network(self) -> ez.NetworkDefinition:
-        return (
-            (self.INPUT, self.OUTPUT),
-        )
+        return ((self.INPUT, self.OUTPUT),)
 
 
 # CORNER CASES
 
-class EmptySystem(ez.System):
+
+class EmptySystem(ez.Collection):
     ...
 
 
-class EmptyTerminateSystem(ez.System):
+class EmptyTerminateSystem(ez.Collection):
     TERMINATE = Terminator()
 
 
-class OnlyPassthroughSystem(ez.System):
+class OnlyPassthroughSystem(ez.Collection):
     TERMINATE = Terminator()
     PASSTHROUGH = PassthroughCollection()
 
     def configure(self) -> None:
-        logger.info('No output expected')
+        ez.logger.info("No output expected")
 
 
 # SYSTEMS WITH HANGING PUBS AND SUBS
 
-class PubNoSubSystem(ez.System):
+
+class PubNoSubSystem(ez.Collection):
     TERMINATE = Terminator()
     GENERATE = Generator()
     LOG = DebugLog()
 
 
-class SubNoPubSystem(ez.System):
+class SubNoPubSystem(ez.Collection):
     TERMINATE = Terminator()
     LISTEN = Listener()
 
     def configure(self) -> None:
-        logger.info('No output expected')
+        ez.logger.info("No output expected")
 
 
-class NoPubNoSubSystem(ez.System):
+class NoPubNoSubSystem(ez.Collection):
     TERMINATE = Terminator()
     MODULUS = Modulus()
 
     def configure(self) -> None:
-        logger.info('No output expected')
+        ez.logger.info("No output expected")
+
 
 # Systems with collections that have hanging pubs and subs
 
@@ -153,26 +154,25 @@ class SubNoPubCollection(ez.Collection):
     LISTEN = Listener()
 
     def network(self) -> ez.NetworkDefinition:
-        return (
-            (self.INPUT, self.LISTEN.INPUT),
-        )
+        return ((self.INPUT, self.LISTEN.INPUT),)
 
 
-class PubNoSubCollectionSystem(ez.System):
+class PubNoSubCollectionSystem(ez.Collection):
     TERMINATE = Terminator()
     COLLECTION = PubNoSubCollection()
 
 
-class SubNoPubCollectionSystem(ez.System):
+class SubNoPubCollectionSystem(ez.Collection):
     TERMINATE = Terminator()
     COLLECTION = SubNoPubCollection()
 
     def configure(self) -> None:
-        logger.info('No output expected')
+        ez.logger.info("No output expected")
 
 
 # Passthrough Collection Tests
 
+
 class PubNoSubPassthroughCollection(ez.Collection):
     COLLECTION = PubNoSubCollection()
     PASSTHROUGH = PassthroughCollection()
@@ -199,20 +199,20 @@ class SubNoPubPassthroughCollection(ez.Collection):
         )
 
 
-class PubNoSubPassthroughCollectionSystem(ez.System):
+class PubNoSubPassthroughCollectionSystem(ez.Collection):
     TERMINATE = Terminator()
     COLLECTION = PubNoSubPassthroughCollection()
 
 
-class SubNoPubPassthroughCollectionSystem(ez.System):
+class SubNoPubPassthroughCollectionSystem(ez.Collection):
     TERMINATE = Terminator()
     COLLECTION = SubNoPubPassthroughCollection()
 
     def configure(self) -> None:
-        logger.info('No output expected')
+        ez.logger.info("No output expected")
 
 
-class PassthroughSystem(ez.System):
+class PassthroughSystem(ez.Collection):
     TERMINATE = Terminator()
     GENERATE = Generator()
     PASSTHROUGH = PassthroughCollection()
@@ -221,12 +221,11 @@ class PassthroughSystem(ez.System):
     def network(self) -> ez.NetworkDefinition:
         return (
             (self.GENERATE.OUTPUT, self.PASSTHROUGH.INPUT),
-            (self.PASSTHROUGH.OUTPUT, self.LOG.INPUT)
+            (self.PASSTHROUGH.OUTPUT, self.LOG.INPUT),
         )
 
 
-if __name__ == '__main__':
-
+if __name__ == "__main__":
     test_systems = [
         EmptySystem,
         EmptyTerminateSystem,
@@ -242,5 +241,5 @@ if __name__ == '__main__':
     ]
 
     for system in test_systems:
-        logger.info(f'Testing { system.__name__ }')
-        ez.run_system(system())
+        ez.logger.info(f"Testing { system.__name__ }")
+        ez.run(system())

{ezmsg-3.2.2 → ezmsg-3.3.0}/examples/ezmsg_count.py

@@ -3,8 +3,8 @@ import array
 from dataclasses import dataclass
 import ezmsg.core as ez
 
-from ezmsg.testing.debuglog import DebugLog, DebugLogSettings
-from ezmsg.testing.terminate import TerminateTest
+from ezmsg.util.debuglog import DebugLog, DebugLogSettings
+from ezmsg.util.terminate import TerminateOnTimeout as TerminateTest
 
 from typing import AsyncGenerator
 
@@ -20,7 +20,6 @@ class CountSettings(ez.Settings):
 
 
 class Count(ez.Unit):
-
     SETTINGS: CountSettings
 
     OUTPUT = ez.OutputStream(int)
@@ -31,8 +30,7 @@ class Count(ez.Unit):
         while True:
             await asyncio.sleep(0.1)
             yield self.OUTPUT, CountMessage(
-                value=count,
-                arr=array.array('b', [0x00] * (2 ** count))
+                value=count, arr=array.array("b", [0x00] * (2**count))
             )
             count = count + 1
 
@@ -41,12 +39,11 @@ class Count(ez.Unit):
 
 
 class CountSystem(ez.System):
-
     COUNT = Count()
     TERM = TerminateTest()
 
-    SUB1 = DebugLog(DebugLogSettings(name='SUB1'))
-    SUB2 = DebugLog(DebugLogSettings(name='SUB2'))
+    SUB1 = DebugLog(DebugLogSettings(name="SUB1"))
+    SUB2 = DebugLog(DebugLogSettings(name="SUB2"))
 
     def network(self) -> ez.NetworkDefinition:
         return (
@@ -59,8 +56,7 @@ class CountSystem(ez.System):
         return (self.COUNT, self.SUB1, self.SUB2)
 
 
-if __name__ == '__main__':
-
+if __name__ == "__main__":
     # import multiprocessing
     # multiprocessing.set_start_method('spawn', force=True)