Zyte-common-items

===================

* Added :meth:`~zyte_common_items.base.ProbabilityMixin.get_probability` helper
method in item classes (e.g. :class:`~zyte_common_items.Product`,
:class:`~zyte_common_items.Article`) and
:class:`~zyte_common_items.ProbabilityRequest`.

===================

* Now requires ``clear-html >= 0.4.0``.

* Added :func:`zyte_common_items.processors.description_processor` and enabled
it for the ``description`` fields in the page classes for
:class:`~zyte_common_items.BusinessPlace`,
:class:`~zyte_common_items.JobPosting`, :class:`~zyte_common_items.Product`
and :class:`~zyte_common_items.RealEstate`.

* Added :func:`zyte_common_items.processors.description_html_processor` and
enabled it for the ``descriptionHtml`` fields in the page classes for
:class:`~zyte_common_items.JobPosting` and
:class:`~zyte_common_items.Product`.

* Added default implementations for the ``description`` (in the page classes
for :class:`~zyte_common_items.BusinessPlace`,
:class:`~zyte_common_items.JobPosting`, :class:`~zyte_common_items.Product`
and :class:`~zyte_common_items.RealEstate`) and ``descriptionHtml`` (in the
page classes for :class:`~zyte_common_items.JobPosting` and
:class:`~zyte_common_items.Product`) fields: if one of these fields is
user-defined, another one will use it.

* :func:`~zyte_common_items.processors.price_processor` and
:func:`~zyte_common_items.processors.simple_price_processor` now keep at
least two decimal places when formatting the result.

===================

* Now requires ``price-parser >= 0.3.4`` (a new dependency) and
``zyte-parsers >= 0.3.0`` (a version increase).

* Added :func:`zyte_common_items.processors.price_processor` and enabled
it for the ``price`` fields.

* Added :func:`zyte_common_items.processors.simple_price_processor` and enabled
it for the ``regularPrice`` fields.

* Added default implementations for the ``currency`` (uses the ``CURRENCY``
attribute on the page class) and ``currencyRaw`` (uses the data extracted by
the ``price`` field) fields.

==================

* Now requires ``web-poet >= 0.14.0``.

* Fixed detection of the :class:`~.HasMetadata` base class.

==================

* Updated minimum versions for the following requirements:

* ``attrs >= 22.1.0``
* ``web-poet >= 0.9.0``
* ``zyte-parsers >= 0.2.0``

* Added :class:`~zyte_common_items.JobPosting` and related classes.

* Added :func:`zyte_common_items.processors.brand_processor` and enabled
it for the ``brand`` fields.

* Added :meth:`zyte_common_items.Request.to_scrapy` to convert
:class:`zyte_common_items.Request` instances to :class:`scrapy.http.Request`
instances.

==================

* Now requires ``zyte-parsers``.

* Added navigation classes: :class:`~zyte_common_items.ArticleNavigation`,
:class:`~zyte_common_items.ProductNavigation`, the page classes that produce
them, and other related classes.

* Improved the metadata field handling, also fixing some bugs:

* Added :ref:`item-specific metadata classes <components-metadata>`. The
``metadata`` item fields were changed to use them.
* **Backward-incompatible change**: the ``DateDownloadedMetadata`` class was
removed. The item-specific ones are now used instead.
* **Backward-incompatible change**:
:class:`~zyte_common_items.ArticleFromList` no longer has a ``probability``
field and instead has a ``metadata`` field like all other similar classes.
* **Backward-incompatible change**: while in most items the old and the new
type of the ``metadata`` field have the same fields, the one in
:class:`~zyte_common_items.Article` now has ``probability``, the one in
:class:`~zyte_common_items.ProductList` no longer has ``probability``, and
the one in :class:`~zyte_common_items.ProductFromList` no longer has
``dateDownloaded``.
* The default ``probability`` value is now ``1.0`` instead of ``None``.
* Added the :class:`~zyte_common_items.HasMetadata` mixin which is used
similarly to :class:`~web_poet.pages.Returns` to set the page metadata
class.
* Metadata objects assigned to the ``metadata`` fields of the items or
returned from the ``metadata()`` methods of the pages are now converted to
suitable classes.

* Added :func:`zyte_common_items.processors.breadcrumbs_processor` and enabled
it for the ``breadcrumbs`` fields.