chore: copy module docstrings into python stub files (#411)

a_sync/a_sync/_helpers.pyi

@@ -1,3 +1,7 @@
+"""
+This module provides utility functions for handling asynchronous operations
+and converting synchronous functions to asynchronous ones.
+"""
 from a_sync._typing import *
 from a_sync import exceptions as exceptions
 

a_sync/a_sync/abstract.pyi

@@ -1,3 +1,13 @@
+"""
+This module provides an abstract base class for defining asynchronous and synchronous behavior.
+
+The :class:`ASyncABC` class uses the :class:`ASyncMeta` metaclass to facilitate the creation of classes
+that can operate in both asynchronous and synchronous contexts. It provides concrete methods to determine
+the execution mode based on flags and keyword arguments.
+
+Note: It is recommended to use :class:`ASyncGenericBase` for most use cases. This class
+is intended for more custom implementations if necessary.
+"""
 from a_sync._typing import *
 import abc
 import functools

a_sync/a_sync/method.pyi

@@ -1,3 +1,10 @@
+"""
+This module provides classes for implementing dual-functional sync/async methods in Python.
+
+It includes descriptors and bound methods that can be used to create flexible
+asynchronous interfaces, allowing methods to be called both synchronously and
+asynchronously based on various conditions and configurations.
+"""
 from a_sync._typing import *
 import functools
 import weakref

a_sync/asyncio/create_task.pyi

@@ -1,3 +1,8 @@
+"""
+This module extends :func:`asyncio.create_task` to support any :class:`Awaitable`,
+manage task lifecycle, and enhance error handling.
+"""
+
 from a_sync._typing import *
 import asyncio
 

a_sync/asyncio/gather.pyi

@@ -1,3 +1,7 @@
+"""
+This module provides an enhanced version of :func:`asyncio.gather`.
+"""
+
 from a_sync._typing import *
 from typing import Any, Awaitable, Dict, List, Mapping, overload
 

a_sync/primitives/_debug.pyi

@@ -1,3 +1,8 @@
+"""
+This module provides a mixin class used to facilitate the creation of debugging daemons in subclasses.
+
+The mixin provides a framework for managing a debug daemon task, which can be used to emit rich debug logs from subclass instances whenever debug logging is enabled. Subclasses must implement the specific logging behavior.
+"""
 import abc
 from a_sync.primitives._loggable import _LoggerMixin
 

a_sync/primitives/_loggable.pyi

@@ -1,3 +1,6 @@
+"""
+This module provides a mixin class to add debug logging capabilities to other classes.
+"""
 from functools import cached_property as cached_property
 from logging import Logger
 

a_sync/task.pyi

@@ -1,3 +1,12 @@
+"""
+This module provides asynchronous task management utilities, specifically focused on creating and handling mappings of tasks.
+
+The main components include:
+- TaskMapping: A class for managing and asynchronously generating tasks based on input iterables.
+- TaskMappingKeys: A view to asynchronously iterate over the keys of a TaskMapping.
+- TaskMappingValues: A view to asynchronously iterate over the values of a TaskMapping.
+- TaskMappingItems: A view to asynchronously iterate over the items (key-value pairs) of a TaskMapping.
+"""
 from a_sync._typing import *
 import asyncio
 from _typeshed import Incomplete

a_sync/task.pyx

@@ -19,7 +19,6 @@ import a_sync.asyncio
 from a_sync import exceptions
 from a_sync._typing import *
 from a_sync.a_sync._kwargs cimport get_flag_name
-from a_sync.a_sync.base import ASyncGenericBase
 from a_sync.a_sync.function import ASyncFunction
 from a_sync.a_sync.method import (
     ASyncBoundMethod,