Merge pull request #272 from scrapy/relnotes-1.8

Release notes for 1.8.0

Author: wRAR

NEWS

@@ -3,6 +3,25 @@
 History
 -------
 
+1.8.0 (YYYY-MM-DD)
+~~~~~~~~~~~~~~~~~~
+
+* Add support for JMESPath: you can now create a selector for a JSON document
+  and call ``Selector.jmespath()``. See :ref:`the documentation
+  <topics-selectors>` for more information and examples.
+* Selectors can now be constructed from ``bytes`` (using the ``body`` and
+  ``encoding`` arguments) instead of ``str`` (using the ``text`` argument), so
+  that there is no internal conversion from ``str`` to ``bytes`` and the memory
+  usage is lower.
+* Typing improvements
+* The ``pkg_resources`` module (which was absent from the requirements) is no
+  longer used
+* Documentation build fixes
+* New requirements:
+
+  * ``jmespath``
+  * ``typing_extensions`` (on Python 3.7)
+
 1.7.0 (2022-11-01)
 ~~~~~~~~~~~~~~~~~~
 

parsel/selector.py

@@ -416,7 +416,10 @@ class Selector:
     You can write selection expressions in CSS or XPath for HTML and XML
     inputs, or in JMESPath for JSON inputs.
 
-    ``text`` is a `str`` object.
+    ``text`` is an ``str`` object.
+
+    ``body`` is a ``bytes`` object. It can be used together with the
+    ``encoding`` argument instead of the ``text`` argument.
 
     ``type`` defines the selector type. It can be ``"html"`` (default),
     ``"json"``, or ``"xml"``.