ez-a-sync 0.23.9__tar.gz → 0.23.11__tar.gz

{ez_a_sync-0.23.9 → ez_a_sync-0.23.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ez-a-sync
-Version: 0.23.9
+Version: 0.23.11
 Summary: A library that makes it easy to define objects that can be used for both sync and async use cases.
 Home-page: https://github.com/BobTheBuidler/a-sync
 Author: BobTheBuidler

{ez_a_sync-0.23.9 → ez_a_sync-0.23.11}/a_sync/__init__.py

@@ -63,7 +63,7 @@ from a_sync.iter import ASyncSorter as sorted
 from a_sync.iter import ASyncIterable, ASyncIterator
 from a_sync.primitives import *
 from a_sync.task import TaskMapping as map
-from a_sync.task import TaskMapping, create_task
+from a_sync.task import TaskMapping
 from a_sync.utils import all, any, as_yielded
 
 # I alias the aliases for your convenience.

{ez_a_sync-0.23.9 → ez_a_sync-0.23.11}/a_sync/_smart.py

@@ -82,9 +82,14 @@ class _SmartFutureMixin(Generic[T]):
         """
         if self.done():
             return self.result()  # May raise too.
+
         self._asyncio_future_blocking = True
-        self._waiters.add(current_task := asyncio.current_task(self._loop))
-        current_task.add_done_callback(self._waiter_done_cleanup_callback)  # type: ignore [union-attr]
+        if current_task := asyncio.current_task(self._loop):
+            self._waiters.add(current_task)
+            current_task.add_done_callback(
+                self._waiter_done_cleanup_callback  # type: ignore [union-attr]
+            )
+
         logger.debug("awaiting %s", self)
         yield self  # This tells Task to wait for completion.
         if not self.done():
@@ -291,7 +296,7 @@ class SmartTask(_SmartFutureMixin[T], asyncio.Task):
         See Also:
             - :func:`asyncio.create_task`
         """
-        super().__init__(coro, loop=loop, name=name)
+        asyncio.Task.__init__(self, coro, loop=loop, name=name)
         self._waiters: Set["asyncio.Task[T]"] = set()
         self.add_done_callback(SmartTask._self_done_cleanup_callback)
 

{ez_a_sync-0.23.9 → ez_a_sync-0.23.11}/a_sync/a_sync/_flags.pyi

@@ -1,8 +1,62 @@
 from typing import Any, Set
 
 AFFIRMATIVE_FLAGS: Set[str]
+"""Set of flags indicating synchronous behavior.
+
+This set currently contains only the flag "sync", which is used to denote
+synchronous operations within the ez-a-sync library.
+
+Examples:
+    >>> 'sync' in AFFIRMATIVE_FLAGS
+    True
+
+    >>> 'async' in AFFIRMATIVE_FLAGS
+    False
+
+See Also:
+    :data:`NEGATIVE_FLAGS`: Flags indicating asynchronous behavior.
+    :data:`VIABLE_FLAGS`: All valid flags, combining both sync and async indicators.
+"""
+
 NEGATIVE_FLAGS: Set[str]
+"""Set of flags indicating asynchronous behavior.
+
+This set currently contains only the flag "asynchronous", which is used to denote
+asynchronous operations within the ez-a-sync library.
+
+Examples:
+    >>> 'asynchronous' in NEGATIVE_FLAGS
+    True
+
+    >>> 'sync' in NEGATIVE_FLAGS
+    False
+
+See Also:
+    :data:`AFFIRMATIVE_FLAGS`: Flags indicating synchronous behavior.
+    :data:`VIABLE_FLAGS`: All valid flags, combining both sync and async indicators.
+"""
+
 VIABLE_FLAGS: Set[str]
+"""Set of all valid flags, combining both synchronous and asynchronous indicators.
+
+The ez-a-sync library uses these flags to indicate whether objects or function
+calls will be synchronous or asynchronous. You can use any of the provided flags,
+whichever makes the most sense for your use case.
+
+Examples:
+    >>> 'sync' in VIABLE_FLAGS
+    True
+
+    >>> 'asynchronous' in VIABLE_FLAGS
+    True
+
+    >>> 'invalid' in VIABLE_FLAGS
+    False
+
+See Also:
+    :data:`AFFIRMATIVE_FLAGS`: Flags indicating synchronous behavior.
+    :data:`NEGATIVE_FLAGS`: Flags indicating asynchronous behavior.
+"""
 
 def negate_if_necessary(flag: str, flag_value: bool) -> bool:
     """Negate the flag value if necessary based on the flag type.