Elasticsearch-dsl

-------------------

* Added support for ``knn`` as a query option (`1770`_)
* Made the ``dims`` attribute of the dense vector type optional (`1776`_)
* Added missing ``inner_hits`` option to ``search.knn()`` method (`1777`_)
* Added support for detecting document updates in ``InnerDoc`` attributes (`1535`_)
* Changed ``_expand__to_dot`` setting to resolve at runtime (`1633`_)
* Added explicit error message when unsupported ``minimum_should_match`` values are used (`1774`_)
* Added the ``EmptySearch`` class (`1780`_)
* Added several missing aggregations:
* ``AdjacencyMatrix`` (`1553`_)
* ``CategorizeText`` (`1588`_)
* ``GeohexGrid`` (`1590`_)
* ``IPPrefix`` (`1592`_)
* ``RandomSampler`` (`1594`_)
* ``GeoLine`` (`1628`_)
* ``MatrixStats`` (`1630`_)
* ``TopMetrics`` (`1706`_)
* Added ``params`` option to the ``FacetedSearch`` object (`1500`_)
* Added support for passing a dictionary in the ``script`` option for a document update (`1560`_)
* Added ``keys()`` and ``items()`` methods to ``AttrDict`` class (`1784`_)
* Added a ``to_list()`` method to the ``AttrList`` class (`1584`_)
* Fixed various documentation issues and typos (`1769`_, `1615`_, `1585`_, `1318`_, `1223`_)
* Added a vector search example (`1778`_)

.. _1770: https://github.com/elastic/elasticsearch-dsl-py/pull/1770
.. _1776: https://github.com/elastic/elasticsearch-dsl-py/pull/1776
.. _1777: https://github.com/elastic/elasticsearch-dsl-py/pull/1777
.. _1535: https://github.com/elastic/elasticsearch-dsl-py/pull/1535
.. _1633: https://github.com/elastic/elasticsearch-dsl-py/pull/1633
.. _1774: https://github.com/elastic/elasticsearch-dsl-py/pull/1774
.. _1780: https://github.com/elastic/elasticsearch-dsl-py/pull/1780
.. _1553: https://github.com/elastic/elasticsearch-dsl-py/pull/1553
.. _1588: https://github.com/elastic/elasticsearch-dsl-py/pull/1588
.. _1590: https://github.com/elastic/elasticsearch-dsl-py/pull/1590
.. _1592: https://github.com/elastic/elasticsearch-dsl-py/pull/1592
.. _1594: https://github.com/elastic/elasticsearch-dsl-py/pull/1594
.. _1628: https://github.com/elastic/elasticsearch-dsl-py/pull/1628
.. _1630: https://github.com/elastic/elasticsearch-dsl-py/pull/1630
.. _1706: https://github.com/elastic/elasticsearch-dsl-py/pull/1706
.. _1500: https://github.com/elastic/elasticsearch-dsl-py/pull/1500
.. _1560: https://github.com/elastic/elasticsearch-dsl-py/pull/1560
.. _1784: https://github.com/elastic/elasticsearch-dsl-py/pull/1784
.. _1584: https://github.com/elastic/elasticsearch-dsl-py/pull/1584
.. _1769: https://github.com/elastic/elasticsearch-dsl-py/pull/1769
.. _1615: https://github.com/elastic/elasticsearch-dsl-py/pull/1615
.. _1585: https://github.com/elastic/elasticsearch-dsl-py/pull/1585
.. _1318: https://github.com/elastic/elasticsearch-dsl-py/pull/1318
.. _1223: https://github.com/elastic/elasticsearch-dsl-py/pull/1223
.. _1778: https://github.com/elastic/elasticsearch-dsl-py/pull/1778

-------------------

* Added ``asyncio`` support (`1714`_)
* Dropped support for Python 3.7 (`1717`_)
* Stopped mixing body and parameters in ``UpdateByQuery`` (`1702`_)

.. _1714: https://github.com/elastic/elasticsearch-dsl-py/pull/1714
.. _1717: https://github.com/elastic/elasticsearch-dsl-py/pull/1717
.. _1702: https://github.com/elastic/elasticsearch-dsl-py/pull/1702

-------------------

* Added ``Search.knn()`` method (`1691`_)
* Added ``Search.rank()`` method (undocumented as it still is in technical preview) (`1692`_)
* Fixed importing collapse from dictionary (`1689`_)

.. _1689: https://github.com/elastic/elasticsearch-dsl-py/pull/1689
.. _1691: https://github.com/elastic/elasticsearch-dsl-py/pull/1691
.. _1692: https://github.com/elastic/elasticsearch-dsl-py/pull/1692

-------------------

* Added support for Python 3.12 (`1680`_)
* Added ``Search.collapse()`` (`1649`_, contributed by `qcoumes`_)

.. _qcoumes: https://github.com/qcoumes
.. _1680: https://github.com/elastic/elasticsearch-dsl-py/pull/1680
.. _1649: https://github.com/elastic/elasticsearch-dsl-py/pull/1649

------------------

* Added Elasticsearch 8.x support (`1664`_)
* Dropped support for Python 2.7 and 3.5 (`1606`_, contributed by `hugovk`_)
* Added support for Python 3.10 and 3.11 (`1608`_, contributed by `hugovk`_)
* Added the ``MultiTerms`` aggregation (`1543`_, contributed by `Telomeraz`_)
* Added the ``CombinedFields`` query (`1557`_, contributed by `Telomeraz`_)

.. _Telomeraz: https://github.com/Telomeraz
.. _hugovk: https://github.com/hugovk
.. _1664: https://github.com/elastic/elasticsearch-dsl-py/pull/1664
.. _1606: https://github.com/elastic/elasticsearch-dsl-py/pull/1606
.. _1608: https://github.com/elastic/elasticsearch-dsl-py/pull/1608
.. _1543: https://github.com/elastic/elasticsearch-dsl-py/pull/1543
.. _1557: https://github.com/elastic/elasticsearch-dsl-py/pull/1557

------------------

* Fixed ``DeprecationWarnings`` that would be emitted from deprecated
usages of the ``body`` parameter in the Python Elasticsearch client.