refactor: move async version of the client to dedicated module

tharropoulos · tharropoulos · commit 87f6e13cc8d0 · 2026-02-04T18:00:57.000+02:00
diff --git a/src/typesense/async_/__init__.py b/src/typesense/async_/__init__.py
@@ -0,0 +1,3 @@
+from .client import AsyncClient  # NOQA
+
+__all__ = ["AsyncClient"]
diff --git a/src/typesense/async_/alias.py b/src/typesense/async_/alias.py
@@ -14,7 +14,7 @@
 Note: This module uses conditional imports to support both Python 3.11+ and earlier versions.
 """
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.types.alias import AliasSchema
 
 
@@ -75,6 +75,6 @@ def _endpoint_path(self) -> str:
         Returns:
             str: The constructed endpoint path.
         """
-        from typesense.async_aliases import AsyncAliases
+        from .aliases import AsyncAliases
 
         return "/".join([AsyncAliases.resource_path, self.name])
diff --git a/src/typesense/async_/aliases.py b/src/typesense/async_/aliases.py
@@ -17,8 +17,8 @@
 
 import sys
 
-from typesense.async_api_call import AsyncApiCall
-from typesense.async_alias import AsyncAlias
+from .api_call import AsyncApiCall
+from .alias import AsyncAlias
 from typesense.types.alias import AliasCreateSchema, AliasSchema, AliasesResponseSchema
 
 if sys.version_info >= (3, 11):
diff --git a/src/typesense/async_/analytics.py b/src/typesense/async_/analytics.py
@@ -1,8 +1,8 @@
 """Client for Typesense Analytics module (async)."""
 
-from typesense.async_analytics_events import AsyncAnalyticsEvents
-from typesense.async_analytics_rules import AsyncAnalyticsRules
-from typesense.async_api_call import AsyncApiCall
+from .analytics_events import AsyncAnalyticsEvents
+from .analytics_rules import AsyncAnalyticsRules
+from .api_call import AsyncApiCall
 
 
 class AsyncAnalytics:
diff --git a/src/typesense/async_/analytics_events.py b/src/typesense/async_/analytics_events.py
@@ -7,7 +7,7 @@
 else:
     import typing_extensions as typing
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.types.analytics import (
     AnalyticsEvent as AnalyticsEventSchema,
     AnalyticsEventCreateResponse,
diff --git a/src/typesense/async_/analytics_rule.py b/src/typesense/async_/analytics_rule.py
@@ -1,6 +1,6 @@
 """Per-rule client for Analytics rules operations (async)."""
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.types.analytics import AnalyticsRuleSchema
 
 
@@ -11,7 +11,7 @@ def __init__(self, api_call: AsyncApiCall, rule_name: str) -> None:
 
     @property
     def _endpoint_path(self) -> str:
-        from typesense.async_analytics_rules import AsyncAnalyticsRules
+        from .analytics_rules import AsyncAnalyticsRules
 
         return "/".join([AsyncAnalyticsRules.resource_path, self.rule_name])
 
diff --git a/src/typesense/async_/analytics_rule_v1.py b/src/typesense/async_/analytics_rule_v1.py
@@ -29,7 +29,7 @@
 
 from typing_extensions import deprecated
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.logger import warn_deprecation
 from typesense.types.analytics_rule_v1 import (
     RuleDeleteSchema,
@@ -109,6 +109,6 @@ def _endpoint_path(self) -> str:
         Returns:
             str: The constructed endpoint path.
         """
-        from typesense.async_analytics_rules_v1 import AsyncAnalyticsRulesV1
+        from .analytics_rules_v1 import AsyncAnalyticsRulesV1
 
         return "/".join([AsyncAnalyticsRulesV1.resource_path, self.rule_id])
diff --git a/src/typesense/async_/analytics_rules.py b/src/typesense/async_/analytics_rules.py
@@ -7,8 +7,8 @@
 else:
     import typing_extensions as typing
 
-from typesense.async_analytics_rule import AsyncAnalyticsRule
-from typesense.async_api_call import AsyncApiCall
+from .analytics_rule import AsyncAnalyticsRule
+from .api_call import AsyncApiCall
 from typesense.types.analytics import (
     AnalyticsRuleCreate,
     AnalyticsRuleSchema,
diff --git a/src/typesense/async_/analytics_rules_v1.py b/src/typesense/async_/analytics_rules_v1.py
@@ -34,8 +34,8 @@
 else:
     import typing_extensions as typing
 
-from typesense.async_analytics_rule_v1 import AsyncAnalyticsRuleV1
-from typesense.async_api_call import AsyncApiCall
+from .analytics_rule_v1 import AsyncAnalyticsRuleV1
+from .api_call import AsyncApiCall
 from typesense.types.analytics_rule_v1 import (
     RuleCreateSchemaForCounters,
     RuleCreateSchemaForQueries,
diff --git a/src/typesense/async_/analytics_v1.py b/src/typesense/async_/analytics_v1.py
@@ -19,8 +19,8 @@
 
 from typing_extensions import deprecated
 
-from typesense.async_analytics_rules_v1 import AsyncAnalyticsRulesV1
-from typesense.async_api_call import AsyncApiCall
+from .analytics_rules_v1 import AsyncAnalyticsRulesV1
+from .api_call import AsyncApiCall
 
 
 @deprecated("AsyncAnalyticsV1 is deprecated on v30+. Use client.analytics instead.")
diff --git a/src/typesense/async_/api_call.py b/src/typesense/async_/api_call.py
@@ -21,7 +21,7 @@
 
 Usage:
     from typesense.configuration import Configuration
-    from typesense.async_api_call import AsyncApiCall
+    from .api_call import AsyncApiCall
 
     config = Configuration(...)
     api_call = AsyncApiCall(config)
diff --git a/src/typesense/async_/client.py b/src/typesense/async_/client.py
@@ -37,23 +37,23 @@
 else:
     import typing_extensions as typing
 
-from typesense.async_aliases import AsyncAliases
-from typesense.async_analytics import AsyncAnalytics
-from typesense.async_analytics_v1 import AsyncAnalyticsV1
-from typesense.async_api_call import AsyncApiCall
-from typesense.async_collection import AsyncCollection
-from typesense.async_collections import AsyncCollections
-from typesense.async_conversations_models import AsyncConversationsModels
-from typesense.async_curation_sets import AsyncCurationSets
-from typesense.async_debug import AsyncDebug
-from typesense.async_keys import AsyncKeys
-from typesense.async_metrics import AsyncMetrics
-from typesense.async_multi_search import AsyncMultiSearch
-from typesense.async_nl_search_models import AsyncNLSearchModels
-from typesense.async_operations import AsyncOperations
-from typesense.async_stemming import AsyncStemming
-from typesense.async_stopwords import AsyncStopwords
-from typesense.async_synonym_sets import AsyncSynonymSets
+from .aliases import AsyncAliases
+from .analytics import AsyncAnalytics
+from .analytics_v1 import AsyncAnalyticsV1
+from .api_call import AsyncApiCall
+from .collection import AsyncCollection
+from .collections import AsyncCollections
+from .conversations_models import AsyncConversationsModels
+from .curation_sets import AsyncCurationSets
+from .debug import AsyncDebug
+from .keys import AsyncKeys
+from .metrics import AsyncMetrics
+from .multi_search import AsyncMultiSearch
+from .nl_search_models import AsyncNLSearchModels
+from .operations import AsyncOperations
+from .stemming import AsyncStemming
+from .stopwords import AsyncStopwords
+from .synonym_sets import AsyncSynonymSets
 from typesense.configuration import ConfigDict, Configuration
 
 TDoc = typing.TypeVar("TDoc", bound=DocumentSchema)
diff --git a/src/typesense/async_/collection.py b/src/typesense/async_/collection.py
@@ -26,10 +26,10 @@
 else:
     import typing_extensions as typing
 
-from typesense.async_api_call import AsyncApiCall
-from typesense.async_documents import AsyncDocuments
-from typesense.async_overrides import AsyncOverrides
-from typesense.async_synonyms import AsyncSynonyms
+from .api_call import AsyncApiCall
+from .documents import AsyncDocuments
+from .overrides import AsyncOverrides
+from .synonyms import AsyncSynonyms
 from typesense.types.document import DocumentSchema
 
 TDoc = typing.TypeVar("TDoc", bound=DocumentSchema, covariant=True)
@@ -155,6 +155,6 @@ def _endpoint_path(self) -> str:
         Returns:
             str: The full endpoint path for the collection.
         """
-        from typesense.async_collections import AsyncCollections
+        from .collections import AsyncCollections
 
         return "/".join([AsyncCollections.resource_path, self.name])
diff --git a/src/typesense/async_/collections.py b/src/typesense/async_/collections.py
@@ -23,8 +23,8 @@
 else:
     import typing_extensions as typing
 
-from typesense.async_api_call import AsyncApiCall
-from typesense.async_collection import AsyncCollection
+from .api_call import AsyncApiCall
+from .collection import AsyncCollection
 from typesense.types.collection import CollectionCreateSchema, CollectionSchema
 from typesense.types.document import DocumentSchema
 
diff --git a/src/typesense/async_/conversation_model.py b/src/typesense/async_/conversation_model.py
@@ -14,7 +14,7 @@
 Note: This module uses conditional imports to support both Python 3.11+ and earlier versions.
 """
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.types.conversations_model import (
     ConversationModelCreateSchema,
     ConversationModelDeleteSchema,
@@ -99,6 +99,6 @@ def _endpoint_path(self) -> str:
         Returns:
             str: The constructed endpoint path.
         """
-        from typesense.async_conversations_models import AsyncConversationsModels
+        from .conversations_models import AsyncConversationsModels
 
         return "/".join([AsyncConversationsModels.resource_path, self.model_id])
diff --git a/src/typesense/async_/conversations_models.py b/src/typesense/async_/conversations_models.py
@@ -17,8 +17,8 @@
 
 import sys
 
-from typesense.async_api_call import AsyncApiCall
-from typesense.async_conversation_model import AsyncConversationModel
+from .api_call import AsyncApiCall
+from .conversation_model import AsyncConversationModel
 from typesense.types.conversations_model import (
     ConversationModelCreateSchema,
     ConversationModelSchema,
diff --git a/src/typesense/async_/curation_set.py b/src/typesense/async_/curation_set.py
@@ -21,7 +21,7 @@
 else:
     import typing_extensions as typing
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.types.curation_set import (
     CurationItemDeleteSchema,
     CurationItemSchema,
@@ -63,7 +63,7 @@ def _endpoint_path(self) -> str:
         Returns:
             str: The full endpoint path for the curation set.
         """
-        from typesense.async_curation_sets import AsyncCurationSets
+        from .curation_sets import AsyncCurationSets
 
         return "/".join([AsyncCurationSets.resource_path, self.name])
 
diff --git a/src/typesense/async_/curation_sets.py b/src/typesense/async_/curation_sets.py
@@ -22,8 +22,8 @@
 else:
     import typing_extensions as typing
 
-from typesense.async_api_call import AsyncApiCall
-from typesense.async_curation_set import AsyncCurationSet
+from .api_call import AsyncApiCall
+from .curation_set import AsyncCurationSet
 from typesense.types.curation_set import CurationSetsListResponseSchema
 
 
@@ -86,6 +86,6 @@ def __getitem__(self, curation_set_name: str) -> AsyncCurationSet:
             >>> curation_sets = AsyncCurationSets(async_api_call)
             >>> products_set = curation_sets["products"]
         """
-        from typesense.async_curation_set import AsyncCurationSet as PerSet
+        from .curation_set import AsyncCurationSet as PerSet
 
         return PerSet(self.api_call, curation_set_name)
diff --git a/src/typesense/async_/debug.py b/src/typesense/async_/debug.py
@@ -21,7 +21,7 @@
 else:
     import typing_extensions as typing
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.types.debug import DebugResponseSchema
 
 
diff --git a/src/typesense/async_/document.py b/src/typesense/async_/document.py
@@ -16,7 +16,7 @@
 
 import sys
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.types.document import (
     DeleteSingleDocumentParameters,
     DirtyValuesParameters,
@@ -137,8 +137,8 @@ def _endpoint_path(self) -> str:
         Returns:
             str: The constructed endpoint path.
         """
-        from typesense.async_collections import AsyncCollections
-        from typesense.async_documents import AsyncDocuments
+        from .collections import AsyncCollections
+        from .documents import AsyncDocuments
 
         return "/".join(
             [
diff --git a/src/typesense/async_/documents.py b/src/typesense/async_/documents.py
@@ -19,8 +19,8 @@
 import json
 import sys
 
-from typesense.async_api_call import AsyncApiCall
-from typesense.async_document import AsyncDocument
+from .api_call import AsyncApiCall
+from .document import AsyncDocument
 from typesense.exceptions import TypesenseClientError
 from typesense.logger import logger
 from typesense.preprocess import stringify_search_params
@@ -377,7 +377,7 @@ def _endpoint_path(self, action: typing.Union[str, None] = None) -> str:
         Returns:
             str: The constructed endpoint path.
         """
-        from typesense.async_collections import AsyncCollections
+        from .collections import AsyncCollections
 
         action = action or ""
         return "/".join(
diff --git a/src/typesense/async_/key.py b/src/typesense/async_/key.py
@@ -14,7 +14,7 @@
 Note: This module uses conditional imports to support both Python 3.11+ and earlier versions.
 """
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.types.key import ApiKeyDeleteSchema, ApiKeySchema
 
 
@@ -75,6 +75,6 @@ def _endpoint_path(self) -> str:
         Returns:
             str: The constructed endpoint path.
         """
-        from typesense.async_keys import AsyncKeys
+        from .keys import AsyncKeys
 
         return "/".join([AsyncKeys.resource_path, str(self.key_id)])
diff --git a/src/typesense/async_/keys.py b/src/typesense/async_/keys.py
@@ -22,8 +22,8 @@
 import json
 import sys
 
-from typesense.async_api_call import AsyncApiCall
-from typesense.async_key import AsyncKey
+from .api_call import AsyncApiCall
+from .key import AsyncKey
 from typesense.types.document import GenerateScopedSearchKeyParams
 from typesense.types.key import (
     ApiKeyCreateResponseSchema,
diff --git a/src/typesense/async_/metrics.py b/src/typesense/async_/metrics.py
@@ -5,7 +5,7 @@
 system and Typesense metrics such as CPU, memory, disk, and network usage.
 
 Classes:
-    MetricsResponse: Type definition for metrics response (imported from typesense.metrics).
+    MetricsResponse: Type definition for metrics response (imported from typesense.types.metrics).
     AsyncMetrics: Manages async retrieval of metrics from the Typesense API.
 
 Dependencies:
@@ -22,8 +22,8 @@
 else:
     import typing_extensions as typing
 
-from typesense.async_api_call import AsyncApiCall
-from typesense.metrics import MetricsResponse
+from .api_call import AsyncApiCall
+from typesense.types.metrics import MetricsResponse
 
 
 class AsyncMetrics:
diff --git a/src/typesense/async_/multi_search.py b/src/typesense/async_/multi_search.py
@@ -18,7 +18,7 @@
 
 import sys
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.preprocess import stringify_search_params
 from typesense.types.document import MultiSearchCommonParameters
 from typesense.types.multi_search import MultiSearchRequestSchema, MultiSearchResponse
diff --git a/src/typesense/async_/nl_search_model.py b/src/typesense/async_/nl_search_model.py
@@ -14,7 +14,7 @@
 Note: This module uses conditional imports to support both Python 3.11+ and earlier versions.
 """
 
-from typesense.async_api_call import AsyncApiCall
+from .api_call import AsyncApiCall
 from typesense.types.nl_search_model import (
     NLSearchModelDeleteSchema,
     NLSearchModelSchema,
@@ -97,6 +97,6 @@ def _endpoint_path(self) -> str:
         Returns:
             str: The constructed endpoint path.
         """
-        from typesense.async_nl_search_models import AsyncNLSearchModels
+        from .nl_search_models import AsyncNLSearchModels
 
         return "/".join([AsyncNLSearchModels.resource_path, self.model_id])
diff --git a/src/typesense/async_/nl_search_models.py b/src/typesense/async_/nl_search_models.py
diff --git a/src/typesense/async_/operations.py b/src/typesense/async_/operations.py
diff --git a/src/typesense/async_/override.py b/src/typesense/async_/override.py
diff --git a/src/typesense/async_/overrides.py b/src/typesense/async_/overrides.py
diff --git a/src/typesense/async_/stemming.py b/src/typesense/async_/stemming.py
diff --git a/src/typesense/async_/stemming_dictionaries.py b/src/typesense/async_/stemming_dictionaries.py
diff --git a/src/typesense/async_/stemming_dictionary.py b/src/typesense/async_/stemming_dictionary.py
diff --git a/src/typesense/async_/stopwords.py b/src/typesense/async_/stopwords.py
diff --git a/src/typesense/async_/stopwords_set.py b/src/typesense/async_/stopwords_set.py
diff --git a/src/typesense/async_/synonym.py b/src/typesense/async_/synonym.py
diff --git a/src/typesense/async_/synonym_set.py b/src/typesense/async_/synonym_set.py
diff --git a/src/typesense/async_/synonym_sets.py b/src/typesense/async_/synonym_sets.py
diff --git a/src/typesense/async_/synonyms.py b/src/typesense/async_/synonyms.py

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+from .client import AsyncClient # NOQA`
	`2`	`+`
	`3`	`+__all__ = ["AsyncClient"]`