valkey-glide 2.0.0rc3__cp310-cp310-macosx_11_0_arm64.whl → 2.2.1rc3__cp310-cp310-macosx_11_0_arm64.whl

glide/__init__.py

@@ -1,13 +1,28 @@
 # Copyright Valkey GLIDE Project Contributors - SPDX Identifier: Apache-2.0
 
-from glide.async_commands.batch import (
-    Batch,
-    ClusterBatch,
-    ClusterTransaction,
-    TBatch,
-    Transaction,
+import sys
+import types
+import warnings
+
+from glide.glide import (
+    ClusterScanCursor,
+    OpenTelemetryConfig,
+    OpenTelemetryMetricsConfig,
+    OpenTelemetryTracesConfig,
+    Script,
 )
-from glide.async_commands.bitmap import (
+from glide_shared import (
+    OK,
+    TOK,
+    AdvancedGlideClientConfiguration,
+    AdvancedGlideClusterClientConfiguration,
+    AggregationType,
+    AllNodes,
+    AllPrimaries,
+    BackoffStrategy,
+    Batch,
+    BatchOptions,
+    BatchRetryStrategy,
     BitEncoding,
     BitFieldGet,
     BitFieldIncrBy,
@@ -20,28 +35,26 @@ from glide.async_commands.bitmap import (
     BitOffsetMultiplier,
     BitOverflowControl,
     BitwiseOperation,
-    OffsetOptions,
-    SignedEncoding,
-    UnsignedEncoding,
-)
-from glide.async_commands.command_args import Limit, ListDirection, ObjectType, OrderBy
-from glide.async_commands.core import (
+    ByAddressRoute,
+    ClosingError,
+    ClusterBatch,
+    ClusterBatchOptions,
+    ClusterTransaction,
     ConditionalChange,
-    CoreCommands,
+    ConfigurationError,
+    ConnectionError,
+    DataType,
+    DistanceMetricType,
+    ExclusiveIdBound,
+    ExecAbortError,
     ExpireOptions,
     ExpiryGetEx,
     ExpirySet,
     ExpiryType,
     ExpiryTypeGetEx,
+    Field,
+    FieldType,
     FlushMode,
-    FunctionRestorePolicy,
-    InfoSection,
-    InsertPosition,
-    OnlyIfEqual,
-    UpdateOptions,
-)
-from glide.async_commands.server_modules import ft, glide_json, json_batch
-from glide.async_commands.server_modules.ft_options.ft_aggregate_options import (
     FtAggregateApply,
     FtAggregateClause,
     FtAggregateFilter,
@@ -49,59 +62,66 @@ from glide.async_commands.server_modules.ft_options.ft_aggregate_options import
     FtAggregateLimit,
     FtAggregateOptions,
     FtAggregateReducer,
+    FtAggregateResponse,
     FtAggregateSortBy,
     FtAggregateSortProperty,
-)
-from glide.async_commands.server_modules.ft_options.ft_create_options import (
-    DataType,
-    DistanceMetricType,
-    Field,
-    FieldType,
     FtCreateOptions,
-    NumericField,
-    TagField,
-    TextField,
-    VectorAlgorithm,
-    VectorField,
-    VectorFieldAttributes,
-    VectorFieldAttributesFlat,
-    VectorFieldAttributesHnsw,
-    VectorType,
-)
-from glide.async_commands.server_modules.ft_options.ft_profile_options import (
+    FtInfoResponse,
     FtProfileOptions,
-    QueryType,
-)
-from glide.async_commands.server_modules.ft_options.ft_search_options import (
+    FtProfileResponse,
     FtSearchLimit,
     FtSearchOptions,
-    ReturnField,
-)
-from glide.async_commands.server_modules.glide_json import (
-    JsonArrIndexOptions,
-    JsonArrPopOptions,
-    JsonGetOptions,
-)
-from glide.async_commands.sorted_set import (
-    AggregationType,
+    FtSearchResponse,
+    FunctionRestorePolicy,
     GeoSearchByBox,
     GeoSearchByRadius,
     GeoSearchCount,
     GeospatialData,
     GeoUnit,
+    GlideClientConfiguration,
+    GlideClusterClientConfiguration,
+    GlideError,
+    HashFieldConditionalChange,
+    IamAuthConfig,
+    IdBound,
     InfBound,
+    InfoSection,
+    InsertPosition,
+    JsonArrIndexOptions,
+    JsonArrPopOptions,
+    JsonGetOptions,
     LexBoundary,
+    Limit,
+    ListDirection,
+    MaxId,
+    MinId,
+    NodeAddress,
+    NumericField,
+    ObjectType,
+    OffsetOptions,
+    OnlyIfEqual,
+    OrderBy,
+    PeriodicChecksManualInterval,
+    PeriodicChecksStatus,
+    ProtocolVersion,
+    PubSubMsg,
+    QueryType,
+    RandomNode,
     RangeByIndex,
     RangeByLex,
     RangeByScore,
+    ReadFrom,
+    RequestError,
+    ReturnField,
+    Route,
     ScoreBoundary,
     ScoreFilter,
-)
-from glide.async_commands.stream import (
-    ExclusiveIdBound,
-    IdBound,
-    MaxId,
-    MinId,
+    ServerCredentials,
+    ServiceType,
+    SignedEncoding,
+    SlotIdRoute,
+    SlotKeyRoute,
+    SlotType,
     StreamAddOptions,
     StreamClaimOptions,
     StreamGroupOptions,
@@ -110,78 +130,105 @@ from glide.async_commands.stream import (
     StreamReadGroupOptions,
     StreamReadOptions,
     StreamTrimOptions,
-    TrimByMaxLen,
-    TrimByMinId,
-)
-from glide.config import (
-    AdvancedGlideClientConfiguration,
-    AdvancedGlideClusterClientConfiguration,
-    BackoffStrategy,
-    GlideClientConfiguration,
-    GlideClusterClientConfiguration,
-    NodeAddress,
-    PeriodicChecksManualInterval,
-    PeriodicChecksStatus,
-    ProtocolVersion,
-    ReadFrom,
-    ServerCredentials,
-)
-from glide.constants import (
-    OK,
-    TOK,
-    FtAggregateResponse,
-    FtInfoResponse,
-    FtProfileResponse,
-    FtSearchResponse,
+    TagField,
+    TBatch,
     TClusterResponse,
     TEncodable,
+    TextField,
     TFunctionListResponse,
     TFunctionStatsFullResponse,
     TFunctionStatsSingleNodeResponse,
+    TimeoutError,
     TJsonResponse,
     TJsonUniversalResponse,
+    TlsAdvancedConfiguration,
+    Transaction,
     TResult,
+    TrimByMaxLen,
+    TrimByMinId,
     TSingleNodeRoute,
     TXInfoStreamFullResponse,
     TXInfoStreamResponse,
+    UnsignedEncoding,
+    UpdateOptions,
+    VectorAlgorithm,
+    VectorField,
+    VectorFieldAttributes,
+    VectorFieldAttributesFlat,
+    VectorFieldAttributesHnsw,
+    VectorType,
+    json_batch,
 )
-from glide.exceptions import (
-    ClosingError,
-    ConfigurationError,
-    ConnectionError,
-    ExecAbortError,
-    GlideError,
-    RequestError,
-    TimeoutError,
-)
-from glide.glide_client import GlideClient, GlideClusterClient, TGlideClient
-from glide.logger import Level as LogLevel
-from glide.logger import Logger
-from glide.routes import (
-    AllNodes,
-    AllPrimaries,
-    ByAddressRoute,
-    RandomNode,
-    Route,
-    SlotIdRoute,
-    SlotKeyRoute,
-    SlotType,
-)
 
-from .glide import ClusterScanCursor, Script
+from .async_commands import ft, glide_json
+from .glide_client import GlideClient, GlideClusterClient, TGlideClient
+from .logger import Level as LogLevel
+from .logger import Logger
+
+_glide_module = sys.modules[__name__]
+
+_legacy_modules = [
+    "glide.exceptions",
+    "glide.config",
+    "glide.constants",
+    "glide.routes",
+    "glide.async_commands",
+    "glide.async_commands.batch",
+    "glide.async_commands.batch_options",
+    "glide.async_commands.bitmap",
+    "glide.async_commands.command_args",
+    "glide.async_commands.server_modules",
+    "glide.async_commands.server_modules.ft_options",
+    "glide.async_commands.server_modules.ft_options.ft_aggregate_options",
+    "glide.async_commands.server_modules.ft_options.ft_create_options",
+    "glide.async_commands.server_modules.ft_options.ft_profile_options",
+    "glide.async_commands.server_modules.ft_options.ft_search_options",
+    "glide.async_commands.server_modules.glide_json",
+    "glide.async_commands.sorted_set",
+    "glide.async_commands.stream",
+]
+
+
+class _LegacyModule(types.ModuleType):
+    """Proxy for a deprecated module that warns when first accessed."""
+
+    def __init__(self, name):
+        super().__init__(name)
+        self._warned = False
+
+    def __getattr__(self, name):
+        if not self._warned:
+            warnings.warn(
+                f"Importing from '{self.__name__}' is deprecated. "
+                f"Please import directly from 'glide' instead.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            self._warned = True
+
+        # Access the attribute from the real top-level glide module
+        return getattr(_glide_module, name)
 
-PubSubMsg = CoreCommands.PubSubMsg
+
+# Replace old modules with lazy proxy modules
+for old_name in _legacy_modules:
+    if old_name not in sys.modules:
+        sys.modules[old_name] = _LegacyModule(old_name)
 
 __all__ = [
     # Client
+    "TGlideClient",
     "GlideClient",
     "GlideClusterClient",
     "Batch",
     "ClusterBatch",
     "ClusterTransaction",
     "Transaction",
-    "TGlideClient",
     "TBatch",
+    # Batch Options
+    "BatchOptions",
+    "BatchRetryStrategy",
+    "ClusterBatchOptions",
     # Config
     "AdvancedGlideClientConfiguration",
     "AdvancedGlideClusterClientConfiguration",
@@ -190,10 +237,16 @@ __all__ = [
     "BackoffStrategy",
     "ReadFrom",
     "ServerCredentials",
+    "ServiceType",
+    "IamAuthConfig",
     "NodeAddress",
+    "OpenTelemetryConfig",
+    "OpenTelemetryMetricsConfig",
+    "OpenTelemetryTracesConfig",
     "ProtocolVersion",
     "PeriodicChecksManualInterval",
     "PeriodicChecksStatus",
+    "TlsAdvancedConfiguration",
     # Response
     "OK",
     "TClusterResponse",
@@ -243,11 +296,11 @@ __all__ = [
     "GeoSearchCount",
     "GeoUnit",
     "GeospatialData",
+    "HashFieldConditionalChange",
     "AggregationType",
     "InfBound",
     "InfoSection",
     "InsertPosition",
-    "ft",
     "LexBoundary",
     "Limit",
     "ListDirection",
@@ -303,6 +356,7 @@ __all__ = [
     "RequestError",
     "TimeoutError",
     # Ft
+    "ft",
     "DataType",
     "DistanceMetricType",
     "Field",