remove DSL code and redirect imports to unified Python client

.readthedocs.yaml

@@ -13,4 +13,5 @@ python:
         - develop
 
 sphinx:
+  configuration: docs/conf.py
   fail_on_warning: true

README

@@ -1,6 +1,13 @@
 Elasticsearch DSL
 =================
 
+> [!NOTE]
+> As of release 9.0, Elasticsearch DSL is part of the official Elasticsearch
+> client for Python, so a separate install is not needed. To migrate, just
+> replace `elasticsearch_dsl` with `elasticsearch.dsl` in all imports.
+>
+> The following instructions apply to versions 8 and older.
+
 Elasticsearch DSL is a high-level library whose aim is to help with writing and
 running queries against Elasticsearch. It is built on top of the official
 low-level client (`elasticsearch-py <https://github.com/elastic/elasticsearch-py>`_).

elasticsearch_dsl/__init__.py

@@ -15,192 +15,14 @@
 #  specific language governing permissions and limitations
 #  under the License.
 
-from . import async_connections, connections
-from .aggs import A, Agg
-from .analysis import analyzer, char_filter, normalizer, token_filter, tokenizer
-from .document import AsyncDocument, Document
-from .document_base import InnerDoc, M, MetaField, mapped_field
-from .exceptions import (
-    ElasticsearchDslException,
-    IllegalOperation,
-    UnknownDslObject,
-    ValidationException,
-)
-from .faceted_search import (
-    AsyncFacetedSearch,
-    DateHistogramFacet,
-    Facet,
-    FacetedResponse,
-    FacetedSearch,
-    HistogramFacet,
-    NestedFacet,
-    RangeFacet,
-    TermsFacet,
-)
-from .field import (
-    Binary,
-    Boolean,
-    Byte,
-    Completion,
-    ConstantKeyword,
-    CustomField,
-    Date,
-    DateRange,
-    DenseVector,
-    Double,
-    DoubleRange,
-    Field,
-    Float,
-    FloatRange,
-    GeoPoint,
-    GeoShape,
-    HalfFloat,
-    Integer,
-    IntegerRange,
-    Ip,
-    IpRange,
-    Join,
-    Keyword,
-    Long,
-    LongRange,
-    Murmur3,
-    Nested,
-    Object,
-    Percolator,
-    Point,
-    RangeField,
-    RankFeature,
-    RankFeatures,
-    ScaledFloat,
-    SearchAsYouType,
-    Shape,
-    Short,
-    SparseVector,
-    Text,
-    TokenCount,
-    construct_field,
-)
-from .function import SF
-from .index import (
-    AsyncComposableIndexTemplate,
-    AsyncIndex,
-    AsyncIndexTemplate,
-    ComposableIndexTemplate,
-    Index,
-    IndexTemplate,
-)
-from .mapping import AsyncMapping, Mapping
-from .query import Q, Query
-from .response import AggResponse, Response, UpdateByQueryResponse
-from .search import (
-    AsyncEmptySearch,
-    AsyncMultiSearch,
-    AsyncSearch,
-    EmptySearch,
-    MultiSearch,
-    Search,
-)
-from .update_by_query import AsyncUpdateByQuery, UpdateByQuery
-from .utils import AttrDict, AttrList, DslBase
-from .wrappers import Range
+import sys
 
-VERSION = (8, 17, 1)
-__version__ = VERSION
-__versionstr__ = ".".join(map(str, VERSION))
-__all__ = [
-    "A",
-    "Agg",
-    "AggResponse",
-    "AsyncComposableIndexTemplate",
-    "AsyncDocument",
-    "AsyncEmptySearch",
-    "AsyncFacetedSearch",
-    "AsyncIndex",
-    "AsyncIndexTemplate",
-    "AsyncMapping",
-    "AsyncMultiSearch",
-    "AsyncSearch",
-    "AsyncUpdateByQuery",
-    "AttrDict",
-    "AttrList",
-    "Binary",
-    "Boolean",
-    "Byte",
-    "Completion",
-    "ComposableIndexTemplate",
-    "ConstantKeyword",
-    "CustomField",
-    "Date",
-    "DateHistogramFacet",
-    "DateRange",
-    "DenseVector",
-    "Document",
-    "Double",
-    "DoubleRange",
-    "DslBase",
-    "ElasticsearchDslException",
-    "EmptySearch",
-    "Facet",
-    "FacetedResponse",
-    "FacetedSearch",
-    "Field",
-    "Float",
-    "FloatRange",
-    "GeoPoint",
-    "GeoShape",
-    "HalfFloat",
-    "HistogramFacet",
-    "IllegalOperation",
-    "Index",
-    "IndexTemplate",
-    "InnerDoc",
-    "Integer",
-    "IntegerRange",
-    "Ip",
-    "IpRange",
-    "Join",
-    "Keyword",
-    "Long",
-    "LongRange",
-    "M",
-    "Mapping",
-    "MetaField",
-    "MultiSearch",
-    "Murmur3",
-    "Nested",
-    "NestedFacet",
-    "Object",
-    "Percolator",
-    "Point",
-    "Q",
-    "Query",
-    "Range",
-    "RangeFacet",
-    "RangeField",
-    "RankFeature",
-    "RankFeatures",
-    "Response",
-    "SF",
-    "ScaledFloat",
-    "Search",
-    "SearchAsYouType",
-    "Shape",
-    "Short",
-    "SparseVector",
-    "TermsFacet",
-    "Text",
-    "TokenCount",
-    "UnknownDslObject",
-    "UpdateByQuery",
-    "UpdateByQueryResponse",
-    "ValidationException",
-    "analyzer",
-    "async_connections",
-    "char_filter",
-    "connections",
-    "construct_field",
-    "mapped_field",
-    "normalizer",
-    "token_filter",
-    "tokenizer",
-]
+from elasticsearch import __version__, dsl  # noqa: F401
+
+modules = [mod for mod in sys.modules.keys() if mod.startswith("elasticsearch.dsl")]
+for mod in modules:
+    sys.modules[mod.replace("elasticsearch.dsl", "elasticsearch_dsl")] = sys.modules[
+        mod
+    ]
+sys.modules["elasticsearch_dsl"].VERSION = __version__
+sys.modules["elasticsearch_dsl"].__versionstr__ = ".".join(map(str, __version__))