ez-a-sync 0.22.15__py3-none-any.whl → 0.22.16__py3-none-any.whl

tests/test_task.py

@@ -10,6 +10,9 @@ async def test_create_task():
 
     Verifies that a task can be created using the `create_task`
     function with a coroutine and a specified name.
+
+    See Also:
+        - :func:`a_sync.create_task`
     """
     t = create_task(coro=asyncio.sleep(0), name="test")
     assert t.get_name() == "test", t
@@ -17,13 +20,16 @@ async def test_create_task():
 
 
 @pytest.mark.asyncio_cooperative
-async def test_persistent_task():
+async def test_persistent_task():  # sourcery skip: simplify-boolean-comparison
     """Test the persistence of a task without a local reference.
 
     Checks if a task created without a local reference
     completes successfully by setting a nonlocal variable.
     The test ensures that the task completes by verifying
     the change in the nonlocal variable.
+
+    See Also:
+        - :func:`a_sync.create_task`
     """
     check = False
 
@@ -43,7 +49,11 @@ async def test_pruning():
     """Test task creation and handling without errors.
 
     Ensures that tasks can be created without causing errors.
-    This test does not explicitly check for task pruning.
+    This test does not explicitly check for task pruning, despite
+    its name, but rather focuses on task creation stability.
+
+    See Also:
+        - :func:`a_sync.create_task`
     """
 
     async def task():
@@ -59,9 +69,12 @@ async def test_pruning():
 async def test_task_mapping_init():
     """Test initialization of TaskMapping.
 
-    Verifies that the TaskMapping class initializes correctly
+    Verifies that the :class:`TaskMapping` class initializes correctly
     with the provided coroutine function and arguments. Checks
     the handling of function arguments and the task name.
+
+    See Also:
+        - :class:`a_sync.TaskMapping`
     """
     tasks = TaskMapping(_coro_fn)
     assert (
@@ -78,9 +91,12 @@ async def test_task_mapping_init():
 async def test_task_mapping():
     """Test the functionality of TaskMapping.
 
-    Checks the behavior of TaskMapping, including task
+    Checks the behavior of :class:`TaskMapping`, including task
     creation, retrieval, and execution. Verifies the ability
     to await the mapping and checks the return values of tasks.
+
+    See Also:
+        - :class:`a_sync.TaskMapping`
     """
     tasks = TaskMapping(_coro_fn)
     # does it return the correct type
@@ -108,10 +124,13 @@ async def test_task_mapping():
 async def test_task_mapping_map_with_sync_iter():
     """Test TaskMapping with a synchronous iterator.
 
-    Verifies that TaskMapping can map over a synchronous
+    Verifies that :class:`TaskMapping` can map over a synchronous
     iterator and correctly handle keys, values, and items.
-    Ensures that mapping in progress raises a RuntimeError
+    Ensures that mapping in progress raises a :class:`RuntimeError`
     when attempted concurrently.
+
+    See Also:
+        - :class:`a_sync.TaskMapping`
     """
     tasks = TaskMapping(_coro_fn)
     i = 0
@@ -168,10 +187,13 @@ async def test_task_mapping_map_with_sync_iter():
 async def test_task_mapping_map_with_async_iter():
     """Test TaskMapping with an asynchronous iterator.
 
-    Verifies that TaskMapping can map over an asynchronous
+    Verifies that :class:`TaskMapping` can map over an asynchronous
     iterator and correctly handle keys, values, and items.
-    Ensures that mapping in progress raises a RuntimeError
+    Ensures that mapping in progress raises a :class:`RuntimeError`
     when attempted concurrently.
+
+    See Also:
+        - :class:`a_sync.TaskMapping`
     """
 
     async def async_iter():
@@ -262,22 +284,19 @@ def test_taskmapping_views_sync():
     """Test synchronous views of TaskMapping.
 
     Checks the synchronous access to keys, values, and items
-    in TaskMapping. Verifies the state of these views before
+    in :class:`TaskMapping`. Verifies the state of these views before
     and after gathering tasks.
+
+    See Also:
+        - :class:`a_sync.TaskMapping`
     """
     tasks = TaskMapping(_coro_fn, range(5))
 
     # keys are currently empty until the loop has a chance to run
-    assert len(tasks.keys()) == 0
-    assert len(tasks.values()) == 0
-    assert len(tasks.items()) == 0
-
+    _assert_len_dictviews(tasks, 0)
     tasks.gather()
 
-    assert len(tasks.keys()) == 5
-    assert len(tasks.values()) == 5
-    assert len(tasks.items()) == 5
-
+    _assert_len_dictviews(tasks, 5)
     for k in tasks.keys():
         assert isinstance(k, int)
 
@@ -295,6 +314,12 @@ def test_taskmapping_views_sync():
         assert isinstance(k, int)
 
 
+def _assert_len_dictviews(tasks, i):
+    assert len(tasks.keys()) == i
+    assert len(tasks.values()) == i
+    assert len(tasks.items()) == i
+
+
 async def _coro_fn(i: int) -> str:
     """Coroutine function for testing.
 
@@ -303,6 +328,9 @@ async def _coro_fn(i: int) -> str:
 
     Returns:
         A string representation of the incremented input.
+
+    See Also:
+        - :func:`a_sync.TaskMapping`
     """
     i += 1
     return str(i) * i

ez_a_sync-0.22.15.dist-info/RECORD

@@ -1,74 +0,0 @@
-a_sync/ENVIRONMENT_VARIABLES.py,sha256=WNRUCRH5RwqGbVVYST_JuJb2MUOMtdf3GW3lsGomp5s,466
-a_sync/__init__.py,sha256=r9VTp-p3GJND5KcotrQGZRoub5eiA-O_ZpgDw15ua2U,3778
-a_sync/_smart.py,sha256=DyHISh-F_xKwoTuGCw3QY6HaGMoA122A5yh2ZUWCTMc,9331
-a_sync/_typing.py,sha256=6oc5XAt9KNMzX91qrmnaGMXe_EH-uNFcuRwczcCtDkA,5411
-a_sync/aliases.py,sha256=TbLyuLeFfJEmcC5-NP6h4DQ9QXlQjGny2NUP_x1tflw,212
-a_sync/exceptions.py,sha256=Qym1qjw35bcD9QxSFvb8D02PjQ_qRiCWGWHABbC8qbI,7290
-a_sync/executor.py,sha256=f8tbcThk1rhuR6smrh7tmna8qOnAZFoaSLe72TRYSWo,13204
-a_sync/future.py,sha256=2gB_-WMZIrXnwT7zgO75czVDqQso6kqZp7pbKItjHKQ,31748
-a_sync/iter.py,sha256=BSFFH3fp3pEyA-8PHcjh4nqwjmh0OLNtyYKVz_XUcbU,21466
-a_sync/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-a_sync/task.py,sha256=jg0H2Stsxp3iMSda5v2PRM253SINXbNRgK16teKm8SQ,31035
-a_sync/a_sync/__init__.py,sha256=qENRGhOVdj0uwYHqGZwDdTTYDepvpb0qjzVJn7Nco78,1814
-a_sync/a_sync/_descriptor.py,sha256=puij54vKOOf5jDl_lSmOSOTfNiHHk_VKZlEBFo-7eDM,8413
-a_sync/a_sync/_flags.py,sha256=UAzMesvTnvc3bqFzSS7A66kNCMf4S7LbQejdtq7TnNA,1959
-a_sync/a_sync/_helpers.py,sha256=yKInVqquvx0KkY2YlLAi86CumiC8dwsA15TTNLlcrsQ,1808
-a_sync/a_sync/_kwargs.py,sha256=tfx0pVe32PAk1m2LmkyDqBVsHbmnNM9gqQ8s0_DNd-s,1380
-a_sync/a_sync/_meta.py,sha256=xMP9LUsdk8M8It2Rc1_HjBI5NZBDf7Y6bt74ljfNuSg,8245
-a_sync/a_sync/abstract.py,sha256=sBmVssbek0OZyxm1Cc-42IcTpahCS0teiVAGWIxzzpM,5787
-a_sync/a_sync/base.py,sha256=rZolx0B4Dof84ahC3pfTDTQe4laZppNnAcliAmNkjDw,7431
-a_sync/a_sync/config.py,sha256=Wvk9oJa8hPrio-meJX4hsRXx0TSIe_UavH7F1cZ-Ptk,3868
-a_sync/a_sync/decorator.py,sha256=eHTpyMJOEBx42s-8Asu4MCTY-VbDBKWo4AK0XuoaIwQ,12317
-a_sync/a_sync/function.py,sha256=rUq43E5qM8j2hN5iZPAYhbBq1NA57OepDEpeNSHkGsc,33369
-a_sync/a_sync/method.py,sha256=yS9Vn6k4BkSExGlZQLC3KPG_qfRCEacKInnHxNDVZpo,24750
-a_sync/a_sync/property.py,sha256=llVqhVksV717ejaDBne7DHBuuMUmHdlsW83wcTElQJQ,25203
-a_sync/a_sync/singleton.py,sha256=tG8E_gT7Qw5Hzgib53TVdMYZa05D5yhLYiHccSZHItc,1460
-a_sync/a_sync/modifiers/__init__.py,sha256=IBDKhGu7XBp7u4ONy6Kmn0Wxdk7WqZoBwHs3590mQuk,2743
-a_sync/a_sync/modifiers/limiter.py,sha256=K-WW4M45oEVvL84Pf11nUVws3hWwflqhyp-VSwLzDMU,2914
-a_sync/a_sync/modifiers/manager.py,sha256=te5BtXw9wm-Zgxn5m3ffFnEkrS7f1xrtBpPpc5fMlmE,5676
-a_sync/a_sync/modifiers/semaphores.py,sha256=GFVYF0n52eet8b1Y0sR0UhZPu43Joj-aQURV9JrZPf8,3921
-a_sync/a_sync/modifiers/cache/__init__.py,sha256=HDs9tBoQyU_DKfam-UGgQUC7Hb3jdHH7vvR0LonoHdw,2889
-a_sync/a_sync/modifiers/cache/memory.py,sha256=V0o_PbFrUlTkom0x013ZZ0oyFLZ0msjxH9Hf0IsmlA4,4266
-a_sync/asyncio/__init__.py,sha256=8xKXPz8Vk4ytvti9zNUgRtGmI5KF3EndgwGHCB5oBHg,519
-a_sync/asyncio/as_completed.py,sha256=I64-uIDKalh20cHC24Mvg71K_NVGRK4KPbYipvDXBXU,8901
-a_sync/asyncio/create_task.py,sha256=kwaDrb8UIqBFv5fZoFmbJfeZvGt6oCbqX9rHXMwqw1Y,4199
-a_sync/asyncio/gather.py,sha256=x1IzwqhP4YatiBLMiZhI7K6mGtVspMggEdeti9X8itU,5885
-a_sync/asyncio/utils.py,sha256=C9XmHO_zU0-Cgob9_YYmqGfyjYyskKqySqyvUcWo7LU,391
-a_sync/primitives/__init__.py,sha256=zpmDwVSUOknQyIOTedyhwRWygiXSmYvjdl83oFAr1Rk,737
-a_sync/primitives/_debug.py,sha256=7TfPphc3e7I46rkLiiLVqxdAS-bBgRvxr5evRaWYYhQ,3077
-a_sync/primitives/_loggable.py,sha256=ngiLMRxQcQP3S4bt8VmBXA52YO9x5bZ0-XEM8sJojPE,1206
-a_sync/primitives/queue.py,sha256=f3lXhk3RyfOMidv5d8C34VYwVjP_hVv67dG-q36lr0E,28577
-a_sync/primitives/locks/__init__.py,sha256=zKSLeCUgMGSbuXN6ehb2dm0-4lbk-Ze8_ldatWEjy4Y,283
-a_sync/primitives/locks/counter.py,sha256=3_4MMKLQtXUzJuuQfr5mrk-rxrv6O2Y8mO66cMH8H0Q,4876
-a_sync/primitives/locks/event.py,sha256=U1suI0OZEH8X3jxF_MChGUtuhemLzROqqd6a7bpHM8E,2974
-a_sync/primitives/locks/prio_semaphore.py,sha256=UnH1uAwxiERdmxvKH8SyF-kq0T76L15ehskOERs4cBo,11982
-a_sync/primitives/locks/semaphore.py,sha256=TnR49MYI_VTvMRN0WAtvF7T9MKqUrUtWlm3CB9g7_XU,6572
-a_sync/sphinx/__init__.py,sha256=UvdsakVmkn0Lw4vEd3jA3_Acymde95-78o87lel8ikk,49
-a_sync/sphinx/ext.py,sha256=3ktEWH1brCbHZi2m4BGwglfLyA5JjF05cB0e_c-MVTg,8997
-a_sync/utils/__init__.py,sha256=4JiGSyL5Jj2G7cAmeQN6fxwFnzyOtWYd9IeX8BhrR2k,3223
-a_sync/utils/iterators.py,sha256=W1EGSBOZy_k7VOiJZyPafqE6vZxzeLO0aeWHfAKur0w,9787
-tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/conftest.py,sha256=cZPQoOF3h1OtsFzEb7Jkx54COExVdf0XfD0LZBrmqcg,57
-tests/executor.py,sha256=vnfaQXP2EmPEQ6SmOgUW0haIq1QSDY-jMxfxyjEeed4,3781
-tests/fixtures.py,sha256=4j3GsopNo6tMFOyhWOb8Hnwcwiw2Xdjee4r1YLH1JBE,5774
-tests/test_abstract.py,sha256=85QVvLeoN7Pvtrjhy0oXmwwmXEctrzvkGWkntXveksQ,542
-tests/test_as_completed.py,sha256=_oy8L4xmK7NvpAaNPLdM6wwPtSD54nGxwQucK9pDvMg,4527
-tests/test_base.py,sha256=aPdg9Oh9wdfcy3pFNyJplbJxwi7x8h2Mmj7jperqTu0,9009
-tests/test_cache.py,sha256=lgcULExF1Nw4cjvujVvxub5CROqatf6TOkluUSVypIY,2562
-tests/test_decorator.py,sha256=OMV2H6JjmGftdIFd5hgHBt80SF29AX8HtvvdyL8covg,3670
-tests/test_executor.py,sha256=s03kTOJBtc8-idsoyCZcS5TGfT9PnioVmJuytKgkcIE,1071
-tests/test_future.py,sha256=9UUFAh6eP1HFkLchprpcnBjKH7TETZr48k-WUt2PKGc,3433
-tests/test_gather.py,sha256=cjl20RIGbLNMn8hhEw9hFQ7qjWpLHIXVDVrAm6H5u4w,1382
-tests/test_helpers.py,sha256=68DBihIMqAIQLkAS89yutfDv3bPsrgIShad7JS6Bqv0,349
-tests/test_iter.py,sha256=jUaRiZMbfOu3HbGPXnijI2C11uXqde62gcPGG71v6m4,8995
-tests/test_limiter.py,sha256=3nyrikkThrTXrx_7J4gR9ZCNXTYIdrgkXF9Av_T1wqc,829
-tests/test_meta.py,sha256=NZyt6tjzypSJO2byY8NuthCXi545SdSeSDp8KBUkp1Q,3663
-tests/test_modified.py,sha256=_O0-HUJLCC4Ok12QtDjT1_OyLJYDgP0K3O0XhrZTGYs,250
-tests/test_semaphore.py,sha256=8WxfS-0eSlrWyRi-x_-KopsGEp_9oX4TgH2QB1DOnCM,1666
-tests/test_singleton.py,sha256=ANhe76xyBIyFzKQcEnSkJTUZICDgf1JGDIMEE4T6dt8,524
-tests/test_task.py,sha256=KFnEFTeKHQHFQD_etxE5_VnfbnGJFsvfSitQ3Mj3U3Q,9616
-ez_a_sync-0.22.15.dist-info/LICENSE.txt,sha256=1on6-17OUMlja6vSPTcmlmeT_DwujCZJijYxaplBvZk,1075
-ez_a_sync-0.22.15.dist-info/METADATA,sha256=PKhUn0WI0kvWKVF2qfRPJKHdPkH7K3CErdT9KhMO8FM,533
-ez_a_sync-0.22.15.dist-info/WHEEL,sha256=a7TGlA-5DaHMRrarXjVbQagU3Man_dCnGIWMJr5kRWo,91
-ez_a_sync-0.22.15.dist-info/top_level.txt,sha256=GVK_7kp7dgBLeHp84iIQdsJmiXnrXd-5sIf2x0Q-VKc,13
-ez_a_sync-0.22.15.dist-info/RECORD,,