Reader

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

Released 2021-02-22

* Add the :meth:`~Reader.update_feeds_iter` method,
which yields the update status of each feed as it gets updated.
(:issue:`204`)
* Change the return type of :meth:`~Reader.update_feed`
from ``None`` to ``Optional[UpdatedFeed]``.
(:issue:`204`)
* Add the ``session_timeout`` argument to :func:`make_reader`
to set a timeout for retrieving HTTP(S) feeds.
The default (connect timeout, read timeout) is (3.05, 60) seconds;
the previous behavior was to *never time out*.
* Use ``PRAGMA user_version`` instead of a version table. (:issue:`210`)
* Use ``PRAGMA application_id`` to identify reader databases;
the id is ``0x66656564`` – ``read`` in ASCII / UTF-8. (:issue:`211`)
* Change the ``reader update`` command to show a progress bar
and update summary (with colors), instead of plain log output.
(:issue:`204`)
* Fix broken Mypy config following 0.800 release. (:issue:`213`)

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

Released 2021-01-29

* JSON Feed support. (:issue:`206`)
* Split feed retrieval from parsing;
should make it easier to add new/custom parsers.
(:issue:`206`)
* Prevent any logging output from the ``reader`` logger by default.
(:issue:`207`)
* In the ``preview_feed_list`` plugin, add ``<link rel=alternative ...>``
tags as a feed detection heuristic.
* In the ``preview_feed_list`` plugin, add ``<a>`` tags as
a *fallback* feed detection heuristic.
* In the web application, fix bug causing the entries page to crash
when counts are enabled.

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

Released 2020-12-13

* Add the ``limit`` and ``starting_after`` arguments to
:meth:`~Reader.get_feeds`, :meth:`~Reader.get_entries`,
and :meth:`~Reader.search_entries`,
allowing them to be used in a paginated fashion.
(:issue:`196`)
* Add the :attr:`~Entry.object_id` property that allows
getting the unique identifier of a data object in a uniform way.
(:issue:`196`)
* In the web application, add links to toggle feed/entry counts. (:issue:`185`)

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

Released 2020-11-28

* Allow disabling feed updates for specific feeds. (:issue:`187`)
* Add methods to get aggregated feed and entry counts. (:issue:`185`)
* In the web application:
allow disabling feed updates for a feed;
allow filtering feeds by whether they have updates enabled;
do not show feed update errors for feeds that have updates disabled.
(:issue:`187`)
* In the web application,
show feed and entry counts when ``?counts=yes`` is used.
(:issue:`185`)
* In the web application,
use YAML instead of JSON for the tags and metadata fields.

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

Released 2020-11-20

* Use indexes for :meth:`~Reader.get_entries()` (recent order);
should make calls 10-30% faster.
(:issue:`134`)
* Allow sorting :meth:`~Reader.search_entries` results randomly.
Allow sorting search results randomly in the web application.
(:issue:`200`)
* Reraise unexpected errors caused by parser bugs
instead of replacing them with an :exc:`AssertionError`.
* Add the ``sqlite_releases`` custom parser plugin.
* Refactor the HTTP feed sub-parser to allow reuse by custom parsers.
* Add a user guide, and improve other parts of the documentation.
(:issue:`194`)

-----------

Released 2020-10-28

* Support Python 3.9. (:issue:`199`)
* Support Windows (requires Python >= 3.9). (:issue:`163`)
* Use GitHub Actions to do macOS and Windows CI builds. (:issue:`199`)
* Rename the ``cloudflare_ua_fix`` plugin to ``ua_fallback``.
Retry any feed that gets a 403, not just those served by Cloudflare.
(:issue:`181`)
* Fix type annotation to avoid mypy 0.790 errors. (:issue:`198`)