Refactor Constants structure: Make _InternalOptions and _Kwargs standalone classes with direct imports

- Extracted _InternalOptions and _Kwargs from nested _Constants classes to standalone classes
- Updated all imports from `from ._constants import _Constants as Constants` + aliases to direct imports: `from ._constants import _InternalOptions, _Kwargs`
- Removed all alias assignments like `_InternalOptions = Constants.InternalOptions` and `_Kwargs = Constants.Kwargs`
- Applied changes across all sync and async files:
  - container.py / aio/_container.py
  - database.py / aio/_database.py
  - cosmos_client.py / aio/_cosmos_client.py
  - _cosmos_client_connection.py / aio/_cosmos_client_connection_async.py
  - _base.py, _request_object.py, _global_partition_endpoint_manager_circuit_breaker.py
- Maintained backward compatibility with Constants access patterns
- All syntax checks pass, imports work correctly

Co-authored-by: bambriz <[email protected]>

Author: Copilot

sdk/cosmos/azure-cosmos/azure/cosmos/_base.py

@@ -38,7 +38,7 @@
 from . import documents
 from . import http_constants
 from . import _runtime_constants
-from ._constants import _Constants as Constants
+from ._constants import _Constants as Constants, _InternalOptions, _Kwargs
 from .auth import _get_authorization_header
 from .offer import ThroughputProperties
 from .partition_key import _Empty, _Undefined
@@ -48,12 +48,8 @@
     from .aio._cosmos_client_connection_async import CosmosClientConnection as AsyncClientConnection
     from ._request_object import RequestObject
 
-# Shorter aliases for convenient usage
-_InternalOptions = Constants.InternalOptions
-_Kwargs = Constants.Kwargs
-
 # InternalOptions alias for cleaner access to internal option constants
-InternalOptions = Constants.InternalOptions
+InternalOptions = _InternalOptions
 
 # pylint: disable=protected-access
 

sdk/cosmos/azure-cosmos/azure/cosmos/_constants.py

@@ -102,7 +102,8 @@ class _Constants:
         )
     }
 
-    class InternalOptions:
+
+class _InternalOptions:
         """Internal option names used in request processing
 
         These constants represent the internal option keys used in the azure-cosmos package
@@ -269,7 +270,8 @@ class InternalOptions:
         MATCH_CONDITION: Final[str] = "matchCondition"
         """Match condition for conditional operations."""
 
-    class Kwargs:
+
+class _Kwargs:
         """Public-facing keyword argument names used in the azure-cosmos package
 
         These constants should be used instead of hardcoded strings for kwargs in public APIs

sdk/cosmos/azure-cosmos/azure/cosmos/_cosmos_client_connection.py

@@ -63,7 +63,7 @@
 from ._change_feed.change_feed_iterable import ChangeFeedIterable
 from ._change_feed.change_feed_state import ChangeFeedState
 from ._change_feed.feed_range_internal import FeedRangeInternalEpk
-from ._constants import _Constants as Constants
+from ._constants import _Constants as Constants, _InternalOptions, _Kwargs
 from ._cosmos_http_logging_policy import CosmosHttpLoggingPolicy
 from ._cosmos_responses import CosmosDict, CosmosList
 from ._range_partition_resolver import RangePartitionResolver
@@ -81,10 +81,6 @@
     _return_undefined_or_empty_partition_key,
 )
 
-# Shorter aliases for convenient usage
-_InternalOptions = Constants.InternalOptions
-_Kwargs = Constants.Kwargs
-
 class CredentialDict(TypedDict, total=False):
     masterKey: str
     resourceTokens: Mapping[str, Any]

sdk/cosmos/azure-cosmos/azure/cosmos/_global_partition_endpoint_manager_circuit_breaker.py

@@ -23,7 +23,7 @@
 """
 from typing import TYPE_CHECKING, Optional
 
-from azure.cosmos._constants import _Constants as Constants
+from azure.cosmos._constants import _Constants as Constants, _InternalOptions, _Kwargs
 from azure.cosmos.partition_key import _get_partition_key_from_partition_key_definition
 from azure.cosmos._global_partition_endpoint_manager_circuit_breaker_core import \
     _GlobalPartitionEndpointManagerForCircuitBreakerCore
@@ -36,10 +36,6 @@
 if TYPE_CHECKING:
     from azure.cosmos._cosmos_client_connection import CosmosClientConnection
 
-# Shorter aliases for convenient usage
-_InternalOptions = Constants.InternalOptions
-_Kwargs = Constants.Kwargs
-
 class _GlobalPartitionEndpointManagerForCircuitBreaker(_GlobalEndpointManager):
     """
     This internal class implements the logic for partition endpoint management for

sdk/cosmos/azure-cosmos/azure/cosmos/_request_object.py

@@ -24,11 +24,7 @@
 from typing import Optional, Mapping, Any, Dict, List
 from .documents import _OperationType
 from .http_constants import ResourceType
-from ._constants import _Constants as Constants
-
-# Shorter aliases for convenient usage
-_InternalOptions = Constants.InternalOptions
-_Kwargs = Constants.Kwargs
+from ._constants import _Constants as Constants, _InternalOptions, _Kwargs
 
 class RequestObject(object): # pylint: disable=too-many-instance-attributes
     def __init__(

sdk/cosmos/azure-cosmos/azure/cosmos/aio/_container.py

@@ -46,7 +46,7 @@
 )
 from .._change_feed.feed_range_internal import FeedRangeInternalEpk
 from .._cosmos_responses import CosmosDict, CosmosList
-from .._constants import _Constants as Constants
+from .._constants import _Constants as Constants, _InternalOptions, _Kwargs
 from .._routing.routing_range import Range
 from .._session_token_helpers import get_latest_session_token
 from ..offer import ThroughputProperties
@@ -56,10 +56,6 @@
     _get_partition_key_from_partition_key_definition, NullPartitionKeyValue, _PartitionKeyType
 )
 
-# Shorter aliases for convenient usage
-_InternalOptions = Constants.InternalOptions
-_Kwargs = Constants.Kwargs
-
 __all__ = ("ContainerProxy",)
 
 # pylint: disable=protected-access, too-many-lines

sdk/cosmos/azure-cosmos/azure/cosmos/aio/_cosmos_client.py

@@ -34,18 +34,14 @@
 from azure.cosmos.offer import ThroughputProperties
 
 from ..cosmos_client import _parse_connection_str
-from .._constants import _Constants as Constants
+from .._constants import _Constants as Constants, _InternalOptions, _Kwargs
 from ._cosmos_client_connection_async import CosmosClientConnection, CredentialDict
 from .._base import build_options as _build_options, _set_throughput_options
 from ._retry_utility_async import _ConnectionRetryPolicy
 from ._database import DatabaseProxy, _get_database_link
 from ..documents import ConnectionPolicy, DatabaseAccount
 from ..exceptions import CosmosResourceNotFoundError
 
-# Shorter aliases for convenient usage
-_InternalOptions = Constants.InternalOptions
-_Kwargs = Constants.Kwargs
-
 # pylint: disable=docstring-keyword-should-match-keyword-only
 
 __all__ = ("CosmosClient",)

sdk/cosmos/azure-cosmos/azure/cosmos/aio/_cosmos_client_connection_async.py

@@ -60,7 +60,7 @@
 from .._change_feed.feed_range_internal import FeedRangeInternalEpk
 from .._routing import routing_range
 from ..documents import ConnectionPolicy, DatabaseAccount
-from .._constants import _Constants as Constants
+from .._constants import _Constants as Constants, _InternalOptions, _Kwargs
 from .._cosmos_responses import CosmosDict, CosmosList
 from .. import http_constants, exceptions
 from . import _query_iterable_async as query_iterable
@@ -83,10 +83,6 @@
 from .._cosmos_http_logging_policy import CosmosHttpLoggingPolicy
 from .._range_partition_resolver import RangePartitionResolver
 
-# Shorter aliases for convenient usage
-_InternalOptions = Constants.InternalOptions
-_Kwargs = Constants.Kwargs
-
 
 
 

sdk/cosmos/azure-cosmos/azure/cosmos/aio/_database.py

@@ -36,7 +36,7 @@
     _deserialize_throughput,
     _replace_throughput
 )
-from .._constants import _Constants as Constants
+from .._constants import _Constants as Constants, _InternalOptions, _Kwargs
 from ._container import ContainerProxy
 from ..offer import ThroughputProperties
 from ..http_constants import StatusCodes
@@ -45,10 +45,6 @@
 from ..documents import IndexingMode
 from ..partition_key import PartitionKey
 
-# Shorter aliases for convenient usage
-_InternalOptions = Constants.InternalOptions
-_Kwargs = Constants.Kwargs
-
 
 __all__ = ("DatabaseProxy",)
 

sdk/cosmos/azure-cosmos/azure/cosmos/aio/_global_partition_endpoint_manager_circuit_breaker_async.py

@@ -23,7 +23,7 @@
 """
 from typing import TYPE_CHECKING, Optional
 
-from azure.cosmos._constants import _Constants as Constants
+from azure.cosmos._constants import _Constants as Constants, _InternalOptions, _Kwargs
 
 from azure.cosmos.partition_key import _get_partition_key_from_partition_key_definition
 from azure.cosmos._global_partition_endpoint_manager_circuit_breaker_core import \
@@ -37,10 +37,6 @@
 if TYPE_CHECKING:
     from azure.cosmos.aio._cosmos_client_connection_async import CosmosClientConnection
 
-# Shorter aliases for convenient usage
-_InternalOptions = Constants.InternalOptions
-_Kwargs = Constants.Kwargs
-
 # pylint: disable=protected-access
 class _GlobalPartitionEndpointManagerForCircuitBreakerAsync(_GlobalEndpointManager):
     """