aiomisc 17.7.1__py3-none-any.whl → 17.7.5__py3-none-any.whl

aiomisc/process_pool.py

@@ -18,9 +18,59 @@ class ProcessPoolStatistic(Statistic):
 
 
 class ProcessPoolExecutor(ProcessPoolExecutorBase, EventLoopMixin):
+    """
+    Process pool executor with statistic
+
+    Usage:
+
+    .. code-block:: python
+
+        from time import sleep
+        from aiomisc import ProcessPoolExecutor
+
+        # NOTE: blocking function must be defined at the top level
+        # of the module to be able to be pickled and sent to the
+        # child processes.
+        def blocking_fn():
+            sleep(1)
+            return 42
+
+        async def main():
+            executor = ProcessPoolExecutor()
+            the_answer = await executor.submit(blocking_fn)
+            print("The answer is:", the_answer)
+
+        asyncio.run(main())
+    """
+
     DEFAULT_MAX_WORKERS = max((cpu_count(), 4))
 
     def __init__(self, max_workers: int = DEFAULT_MAX_WORKERS, **kwargs: Any):
+        """
+        Initializes a new ProcessPoolExecutor instance.
+
+        * ``max_workers``:
+          The maximum number of processes that can be used to
+          execute the given calls. If None or not given then
+          as many worker processes will be created as the
+          machine has processors.
+        * ``mp_context``:
+          A multiprocessing context to launch the workers. This
+          object should provide SimpleQueue, Queue and Process.
+          Useful to allow specific multiprocessing start methods.
+        * ``initializer``:
+          A callable used to initialize worker processes.
+        * ``initargs``:
+          A tuple of arguments to pass to the initializer.
+        * ``max_tasks_per_child``:
+          The maximum number of tasks a worker process
+          can complete before it will exit and be replaced
+          with a fresh worker process. The default of None
+          means worker process will live as long as the
+          executor. Requires a non-'fork' mp_context start
+          method. When given, we default to using 'spawn'
+          if no mp_context is supplied.
+        """
         super().__init__(max_workers=max_workers, **kwargs)
         self._statistic = ProcessPoolStatistic()
         self._statistic.processes = max_workers
@@ -31,6 +81,9 @@ class ProcessPoolExecutor(ProcessPoolExecutorBase, EventLoopMixin):
         start_time: float,
         loop: asyncio.AbstractEventLoop,
     ) -> None:
+        """
+        Callback for statistic
+        """
         if future.exception():
             self._statistic.error += 1
         else:
@@ -52,4 +105,7 @@ class ProcessPoolExecutor(ProcessPoolExecutorBase, EventLoopMixin):
         return future
 
     def __del__(self) -> None:
+        """
+        Cleanup resources
+        """
         self.shutdown()

aiomisc/recurring.py

@@ -48,14 +48,14 @@ class RecurringCallback:
 
     def __init__(
         self, coroutine_func: CallbackType,
-        *args: Any, **kwargs: Any,
+        *args: Any, name: Optional[str] = None, **kwargs: Any,
     ):
         self.func: Callable[..., Awaitable[Any]]
         self.args: Tuple[Any, ...]
         self.kwargs: Mapping[str, Any]
         self._statistic: RecurringCallbackStatistic
 
-        self.name: str = repr(coroutine_func)
+        self.name: str = name or repr(coroutine_func)
         self._statistic = RecurringCallbackStatistic(name=self.name)
         self.func = utils.awaitable(coroutine_func)
         self.args = args

aiomisc/service/periodic.py

@@ -15,9 +15,9 @@ class PeriodicService(Service):
     interval: Union[int, float]
     delay: Union[int, float] = 0
 
-    def __init__(self, **kwargs: Any):
+    def __init__(self, *, name: Optional[str] = None, **kwargs: Any):
         super().__init__(**kwargs)
-        self.periodic = PeriodicCallback(self.callback)
+        self.periodic = PeriodicCallback(self.callback, name=name)
 
     async def start(self) -> None:
         assert self.interval, f"Interval illegal interval {self.interval!r}"

aiomisc/version.py

@@ -2,5 +2,5 @@
 # BY: poem-plugins "git" plugin
 # NEVER EDIT THIS FILE MANUALLY
 
-version_info = (17, 7, 1)
-__version__ = "17.7.1"
+version_info = (17, 7, 5)
+__version__ = "17.7.5"

{aiomisc-17.7.1.dist-info → aiomisc-17.7.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aiomisc
-Version: 17.7.1
+Version: 17.7.5
 Summary: aiomisc - miscellaneous utils for asyncio
 License: MIT
 Author: Dmitry Orlov

{aiomisc-17.7.1.dist-info → aiomisc-17.7.5.dist-info}/RECORD

@@ -15,9 +15,9 @@ aiomisc/periodic.py,sha256=OFYZbPkcGgeMjBk8zwsLr2TqPRTS6MNewaL3q9qK5js,2252
 aiomisc/plugins/__init__.py,sha256=eHKGec_217rBjXGf8u-Joyf7dzpO1O0QAuFan1IEyYE,1057
 aiomisc/plugins/__main__.py,sha256=y3mykRQmimDRHb_PvY4n08vegjWTjd9CONFbCecAxxw,1365
 aiomisc/pool.py,sha256=kmTEziX7U1kXxmNsTEain9Jkzn8ZbFubuCYWaozZoRk,5764
-aiomisc/process_pool.py,sha256=tYSWEXxCP-QXum2TFhyQzyvg86JUSo7EUcrCI7si2-c,1614
+aiomisc/process_pool.py,sha256=3O5FSIVQ6r-jf07Oyjs8Zt0wTL6cNZpV-tENwuQB63Y,3468
 aiomisc/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-aiomisc/recurring.py,sha256=LJ13P_OhZM6mVOed8iUrS-M9PXY12516XBZcFtO7XtI,4923
+aiomisc/recurring.py,sha256=KjqirbRscmNUk53xn0zyGCq2hmQZkceLERJngRyrzNQ,4959
 aiomisc/service/__init__.py,sha256=_JSkI4Q78UljG4CvhK6He2UGLxJaQS6cVwZ9QT0cSWo,607
 aiomisc/service/aiohttp.py,sha256=Lfw1dm77zscBZP0H4sKYlVye7RfE0EPWeSSX5V-mvD0,4091
 aiomisc/service/asgi.py,sha256=S6ejgg7GpHfUzuj46g8QuLXTHn0YWwqI_pAGbXfoNjE,1583
@@ -31,7 +31,7 @@ aiomisc/service/dns/store.py,sha256=PCYp-H1UoFzUVaYfSnK78_TG3fw1CeIzg-ndMgu_cE4,
 aiomisc/service/dns/tree.py,sha256=q9VRcVxggrClUHyGZZqqSByMaHdU4nYPC1NdT17cVWM,1575
 aiomisc/service/dns/zone.py,sha256=6Xmrl_leLalSiRQWWNuwGtZVw31Y93i9K2j0JU1vt-4,2174
 aiomisc/service/grpc_server.py,sha256=G1iRGX3jAfv3fpzNnw_n6UuhORmIZK4cz6aAi7t7qcU,4553
-aiomisc/service/periodic.py,sha256=BEKGWxWDOX11sfo7MFYp-hiB5iZ4-c2BRsjS56k5B-0,1241
+aiomisc/service/periodic.py,sha256=Q871Kw6L_L4EDKVl_0pJI2eLWpAjwYs9FnLKeCc9lBY,1283
 aiomisc/service/process.py,sha256=mZf8muZJNWQo95pUmzchMk08MJMhLifFK8m4CnNX49k,4477
 aiomisc/service/profiler.py,sha256=6KiJsU7tD5eO4YKZXYujV2E8P-G8GUqLAGIl0AuPNG4,1503
 aiomisc/service/raven.py,sha256=VHqnXWx-_r71_pjFniIB_E4CgT2reuRD1EB4yEC0hzE,12214
@@ -45,7 +45,7 @@ aiomisc/signal.py,sha256=_iiC2jukXg7-LLirIl1YATlKIIsKLbmTNFr1Ezheu7g,1728
 aiomisc/thread_pool.py,sha256=591u5HV1aBmBRcaVm4kAtMLPZOb6veqhT9wkts_knqE,14017
 aiomisc/timeout.py,sha256=5jNDooLW4MAe6ZUIKhkiX29CoyI0zlXd-dZoZwQPxak,920
 aiomisc/utils.py,sha256=6yTfTpeRCVzfZp-MJCmB1oayOHUBVwQwzC3U5PBAjn8,11919
-aiomisc/version.py,sha256=ilCS52JKzZl7hvZBGb2kc1YcDTr33fTbVWDUYneN5D4,154
+aiomisc/version.py,sha256=8FWFY2OsZehRQ96kno-8V30CZiUv1mszZ4ccoyij48I,154
 aiomisc/worker_pool.py,sha256=GA91KdOrBlqHthbVSTxu_d6BsBIbl-uKqW2NxqSafG0,11107
 aiomisc_log/__init__.py,sha256=N3g8Ea1YE2dWPDd-MwohuAn3Y0pBxSyL4l4Jsxqkv0Q,4854
 aiomisc_log/enum.py,sha256=_zfCZPYCGyI9KL6TqHiYVlOfA5U5MCbsuCuDKxDHdxg,1549
@@ -63,8 +63,8 @@ aiomisc_worker/process_inner.py,sha256=8ZtjCSLrgySW57OIbuGrpEWxfysRLYKx1or1YaAqx
 aiomisc_worker/protocol.py,sha256=1smmlBbdreSmnrxuhHaUMUC10FO9xMIEcedhweQJX_A,2705
 aiomisc_worker/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 aiomisc_worker/worker.py,sha256=f8nCFhlKh84UUBUaEgCllwMRvVZiD8_UUXaeit6g3T8,3236
-aiomisc-17.7.1.dist-info/COPYING,sha256=Ky_8CQMaIixfyOreUBsl0hKN6A5fLnPF8KPQ9molMYA,1125
-aiomisc-17.7.1.dist-info/METADATA,sha256=LO9OgOb81BQZvB91ZWZp_T-p3piEI4ASpJOgSJu0baQ,15685
-aiomisc-17.7.1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-aiomisc-17.7.1.dist-info/entry_points.txt,sha256=KRsSPCwKJyGTWrvzpwbS0yIDwzsgDA2X6f0CBWYmNao,55
-aiomisc-17.7.1.dist-info/RECORD,,
+aiomisc-17.7.5.dist-info/COPYING,sha256=Ky_8CQMaIixfyOreUBsl0hKN6A5fLnPF8KPQ9molMYA,1125
+aiomisc-17.7.5.dist-info/METADATA,sha256=7dISlxwcKVqF6kKOhpWI-mWXecHOvXzOPO5a4wQOQGI,15685
+aiomisc-17.7.5.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+aiomisc-17.7.5.dist-info/entry_points.txt,sha256=KRsSPCwKJyGTWrvzpwbS0yIDwzsgDA2X6f0CBWYmNao,55
+aiomisc-17.7.5.dist-info/RECORD,,

{aiomisc-17.7.1.dist-info → aiomisc-17.7.5.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.1
+Generator: poetry-core 2.1.2
 Root-Is-Purelib: true
 Tag: py3-none-any