aiomisc 17.7.1__py3-none-any.whl → 17.7.3__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/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, 3)
+__version__ = "17.7.3"

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

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

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

@@ -15,7 +15,7 @@ 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/service/__init__.py,sha256=_JSkI4Q78UljG4CvhK6He2UGLxJaQS6cVwZ9QT0cSWo,607
@@ -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=Y_Hh7bO575bzAAjob0MVcTO2snhkxY071G3VN3jeJlY,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.3.dist-info/COPYING,sha256=Ky_8CQMaIixfyOreUBsl0hKN6A5fLnPF8KPQ9molMYA,1125
+aiomisc-17.7.3.dist-info/METADATA,sha256=NphOM-GzSvENM9m8BK0lptTofiQqACJiag1UC9atxyE,15685
+aiomisc-17.7.3.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+aiomisc-17.7.3.dist-info/entry_points.txt,sha256=KRsSPCwKJyGTWrvzpwbS0yIDwzsgDA2X6f0CBWYmNao,55
+aiomisc-17.7.3.dist-info/RECORD,,