elasticsearch 8.11.1__tar.gz → 8.12.0__tar.gz

{elasticsearch-8.11.1 → elasticsearch-8.12.0}/CONTRIBUTING.md

@@ -13,7 +13,7 @@ before writing too much code.
 ## Running Elasticsearch locally
 
 We've provided a script to start an Elasticsearch cluster of a certain version
-found at `.ci/run-elasticsearch.sh`.
+found at `.buildkite/run-elasticsearch.sh`.
 
 There are several environment variables that control integration tests:
 

{elasticsearch-8.11.1 → elasticsearch-8.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: elasticsearch
-Version: 8.11.1
+Version: 8.12.0
 Summary: Python client for Elasticsearch
 Home-page: https://github.com/elastic/elasticsearch-py
 Author: Elastic Client Library Maintainers
@@ -15,7 +15,6 @@ Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
@@ -24,7 +23,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: >=3.6
+Requires-Python: >=3.7
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 License-File: NOTICE

elasticsearch-8.12.0/docs/sphinx/api/esql.rst

@@ -0,0 +1,9 @@
+.. _esql:
+
+ES|QL
+-----
+.. py:module:: elasticsearch.client
+   :noindex:
+
+.. autoclass:: EsqlClient
+   :members:

elasticsearch-8.12.0/docs/sphinx/api/inference.rst

@@ -0,0 +1,9 @@
+.. _inference:
+
+Inference
+---------
+.. py:module:: elasticsearch.client
+   :noindex:
+
+.. autoclass:: InferenceClient
+   :members:

{elasticsearch-8.11.1 → elasticsearch-8.12.0}/docs/sphinx/api.rst

@@ -10,7 +10,7 @@ arguments are required for all calls.
 .. note::
 
    Some API parameters in Elasticsearch are reserved keywords in Python.
-   For example the ``from`` query parameter for pagination would be aliased as 
+   For example the ``from`` query parameter for pagination would be aliased as
    ``from_``.
 
 .. toctree::
@@ -24,10 +24,12 @@ arguments are required for all calls.
    api/dangling-indices
    api/enrich-policies
    api/eql
+   api/esql
    api/fleet
    api/graph-explore
    api/index-lifecycle-management
    api/indices
+   api/inference
    api/ingest-pipelines
    api/license
    api/logstash

{elasticsearch-8.11.1 → elasticsearch-8.12.0}/docs/sphinx/async.rst

@@ -4,22 +4,17 @@ Using Asyncio with Elasticsearch
  .. py:module:: elasticsearch
     :no-index:
 
-Starting in ``elasticsearch-py`` v7.8.0 for Python 3.6+ the ``elasticsearch`` package supports async/await with
+The ``elasticsearch`` package supports async/await with
 `Asyncio <https://docs.python.org/3/library/asyncio.html>`_ and `Aiohttp <https://docs.aiohttp.org>`_.
 You can either install ``aiohttp`` directly or use the ``[async]`` extra:
 
  .. code-block:: bash
 
-    $ python -m pip install elasticsearch>=7.8.0 aiohttp
+    $ python -m pip install elasticsearch aiohttp
 
     # - OR -
 
-    $ python -m pip install elasticsearch[async]>=7.8.0
-
- .. note::
-    Async functionality is a new feature of this library in v7.8.0+ so
-    `please open an issue <https://github.com/elastic/elasticsearch-py/issues>`_
-    if you find an issue or have a question about async support.
+    $ python -m pip install elasticsearch[async]
 
 Getting Started with Async
 --------------------------
@@ -67,13 +62,13 @@ in the ``examples/fastapi-apm`` directory.
 Frequently Asked Questions
 --------------------------
 
-NameError / ImportError when importing ``AsyncElasticsearch``?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ValueError when initializing ``AsyncElasticsearch``?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If when trying to use ``AsyncElasticsearch`` and you're receiving a ``NameError`` or ``ImportError``
-you should ensure that you're running Python 3.6+ (check with ``$ python --version``) and
-that you have ``aiohttp`` installed in your environment (check with ``$ python -m pip freeze | grep aiohttp``).
-If either of the above conditions is not met then async support won't be available.
+If when trying to use ``AsyncElasticsearch`` you receive ``ValueError: You must
+have 'aiohttp' installed to use AiohttpHttpNode`` you should ensure that you
+have ``aiohttp`` installed in your environment (check with ``$ python -m pip
+freeze | grep aiohttp``). Otherwise, async support won't be available.
 
 What about the ``elasticsearch-async`` package?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

{elasticsearch-8.11.1 → elasticsearch-8.12.0}/docs/sphinx/index.rst

@@ -38,8 +38,8 @@ Language clients are forward compatible; meaning that clients support communicat
 with greater or equal minor versions of Elasticsearch. Elasticsearch language clients
 are only backwards compatible with default distributions and without guarantees made.
 
-If you have a need to have multiple versions installed at the same time older
-versions are also released as ``elasticsearch2``, ``elasticsearch5`` and ``elasticsearch6``.
+If you need multiple versions installed at the same time, versions are
+also released, such as ``elasticsearch7`` and ``elasticsearch8``.
 
 
 Example Usage
@@ -49,25 +49,28 @@ Example Usage
 
     from datetime import datetime
     from elasticsearch import Elasticsearch
-    es = Elasticsearch()
+
+    es = Elasticsearch("http://localhost:9200")
 
     doc = {
-        'author': 'kimchy',
-        'text': 'Elasticsearch: cool. bonsai cool.',
-        'timestamp': datetime.now(),
+        "author": "kimchy",
+        "text": "Elasticsearch: cool. bonsai cool.",
+        "timestamp": datetime.now(),
     }
     resp = es.index(index="test-index", id=1, document=doc)
-    print(resp['result'])
+    print(resp["result"])
 
     resp = es.get(index="test-index", id=1)
-    print(resp['_source'])
+    print(resp["_source"])
 
     es.indices.refresh(index="test-index")
 
     resp = es.search(index="test-index", query={"match_all": {}})
-    print("Got %d Hits:" % resp['hits']['total']['value'])
-    for hit in resp['hits']['hits']:
-        print("%(timestamp)s %(author)s: %(text)s" % hit["_source"])
+    print("Got {} hits:".format(resp["hits"]["total"]["value"]))
+    for hit in resp["hits"]["hits"]:
+        print("{timestamp} {author} {text}".format(**hit["_source"]))
+
+See more examples in the :ref:`quickstart` page.
 
 
 

{elasticsearch-8.11.1 → elasticsearch-8.12.0}/docs/sphinx/quickstart.rst

@@ -1,4 +1,6 @@
-Quickstart 
+.. _quickstart:
+
+Quickstart
 ==========
 
 This guide shows you how to install the Elasticsearch Python client and perform basic
@@ -7,7 +9,7 @@ operations like indexing or searching documents.
 Requirements
 ------------
 
-- `Python <https://www.python.org/>`_ 3.6 or newer
+- `Python <https://www.python.org/>`_ 3.7 or newer
 - `pip <https://pip.pypa.io/en/stable/>`_