reader 3.26__tar.gz → 3.27__tar.gz

{reader-3.26 → reader-3.27}/CHANGES.rst

@@ -6,6 +6,29 @@ Changelog
   :no-index:
 
 
+Version 3.27
+------------
+
+Released 2026-10-11
+
+* Add the ``migrate`` :func:`make_reader` argument.
+  Thanks to `Divyanshi Purohit`_ for the PR.
+  (:issue:`403`)
+* Add :attr:`~EntryCounts.unread` property to
+  :class:`EntryCounts` and :class:`EntrySearchCounts`.
+  (:issue:`283`)
+
+* Support Python 3.15. (:issue:`418`)
+* Support PyPy 3.12. (:issue:`419`)
+* Drop Python 3.11 support. (:issue:`419`)
+
+* Stop vendoring `feedparser`_ and
+  :ref:`recommend installing it from GitHub instead <no-vendored-feedparser>`.
+* Pin GitHub Actions and add zizmor to CI.
+
+.. _Divyanshi Purohit: https://github.com/divyanshi555
+
+
 Version 3.26
 ------------
 
@@ -592,7 +615,7 @@ Released 2023-08-20
 
 * Make :exc:`ReaderWarning` inherit from :exc:`ReaderError`.
 
-* Include a diagram of the :ref:`exctree` in the :doc:`api`.
+* Include a diagram of the :ref:`exception hierarchy <exctree>` in the :doc:`api`.
 
 * Add werkzeug dependency,
   instead of vendoring selected :mod:`werkzeug.http` utilities.

{reader-3.26/src/reader.egg-info → reader-3.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reader
-Version: 3.26
+Version: 3.27
 Summary: A Python feed reader library.
 Author: lemon24
 License: BSD-3-Clause
@@ -19,10 +19,10 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Internet
@@ -32,7 +32,7 @@ Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
-Requires-Python: >=3.11
+Requires-Python: >=3.12
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: typing-extensions>=4

{reader-3.26 → reader-3.27}/docs/api.rst

@@ -60,9 +60,11 @@ Data objects
 
 .. autoclass:: EntryCounts
     :members:
+    :inherited-members:
 
 .. autoclass:: EntrySearchCounts
     :members:
+    :inherited-members:
 
 .. autoclass:: UpdateResult
     :members:
@@ -85,9 +87,16 @@ Data objects
 
 
 
+.. _exctree:
+
 Exceptions
 ----------
 
+The class hierarchy for :mod:`reader` exceptions is:
+
+.. classtree:: ReaderError
+
+
 .. autoexception:: ReaderError
     :members:
 
@@ -180,16 +189,6 @@ Exceptions
     :show-inheritance:
 
 
-.. _exctree:
-
-Exception hierarchy
-~~~~~~~~~~~~~~~~~~~
-
-The class hierarchy for :mod:`reader` exceptions is:
-
-.. classtree:: ReaderError
-
-
 
 Enumerations
 ------------

{reader-3.26 → reader-3.27}/docs/conf.py

@@ -78,7 +78,7 @@ autodoc_typehints_description_target = 'documented'
 autodoc_type_aliases = {
     'ResourceInput': 'reader.types.ResourceInput',
     'AnyResourceInput': 'reader.types.AnyResourceInput',
-    'JSONType': 'reader.types.JSONType',
+    'JSON': 'reader.types.JSON',
     'TagFilter': 'reader._types.TagFilter',
     'TristateFilter': 'reader._types.TristateFilter',
 }
@@ -226,5 +226,19 @@ def class_tree(cls):
     return '\n'.join(output(classes)) + '\n'
 
 
+import builtins
+
+std_dir = builtins.dir
+
+
+def source_order_dir(obj):
+    if isinstance(obj, type):
+        return [name for cls in obj.mro() for name in cls.__dict__.keys()]
+    return std_dir(obj)
+
+
 def setup(app):
     app.add_directive("classtree", ClassTree)
+
+    # TODO: remove when https://github.com/sphinx-doc/sphinx/issues/628 is resolved
+    builtins.dir = source_order_dir

{reader-3.26 → reader-3.27}/docs/guide.rst

@@ -137,6 +137,16 @@ since each connection would be to a *different* database::
 .. _temporary: https://sqlite.org/inmemorydb.html#temp_db
 
 
+Migrations
+~~~~~~~~~~
+
+Schema migrations depend on the storage used.
+
+For the default SQLite storage,
+migrations happen automatically during :func:`make_reader`,
+unless you pass ``migrate=False``.
+
+
 .. _backups:
 
 Backups

{reader-3.26 → reader-3.27}/docs/install.rst

@@ -28,14 +28,12 @@ These packages will be installed automatically when installing *reader*:
 
 .. note::
 
-  Because `feedparser`_ makes PyPI releases at a lower cadence,
-  *reader* uses a vendored version of feedparser's `develop`_ branch
-  by default since :ref:`version 2.9`.
-  To opt out of this behavior, and make *reader* use
-  the installed ``feedparser`` package,
-  set the ``READER_NO_VENDORED_FEEDPARSER`` environment variable to ``1``.
-
-.. _develop: https://github.com/kurtmckee/feedparser
+  The `feedparser`_ ``main`` branch contains a `change`_
+  that decreases memory usage by ~35% during feed updates;
+  as of feedparser 6.0.14, this change is not yet included in PyPI releases;
+  to benefit from it, install feedparser directly from GitHub.
+
+  .. _change: https://github.com/kurtmckee/feedparser/pull/302
 
 
 .. _optional dependencies:

{reader-3.26 → reader-3.27}/docs/internal.rst

@@ -87,7 +87,7 @@ Data objects
 .. autoclass:: ParsedFeed
     :members:
 
-.. autoclass:: HTTPInfo
+.. autoclass:: RetrieveMetadata
     :members:
 
 

{reader-3.26 → reader-3.27}/pyproject.toml

@@ -19,10 +19,10 @@ classifiers = [
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",
     "Topic :: Internet",
@@ -33,7 +33,7 @@ classifiers = [
     "Topic :: Utilities",
     "Typing :: Typed",
 ]
-requires-python = ">=3.11"
+requires-python = ">=3.12"
 dependencies = [
     "typing-extensions>=4",
     "feedparser>=6",
@@ -176,6 +176,9 @@ files = ["src"]
 show_error_codes = true
 pretty = true
 strict = true
+strict_equality_for_none = true
+warn_unreachable = true
+
 [[tool.mypy.overrides]]
 module = [
     "reader.__main__",
@@ -190,7 +193,6 @@ module = [
     "reader.plugins.readtime",
     "reader.plugins.mark_as_read",
     "reader.plugins.autodiscover",
-    "reader._vendor.feedparser.*",
 ]
 ignore_errors = true
 

{reader-3.26 → reader-3.27}/scripts/release.py

@@ -20,18 +20,8 @@ def run(*args, **kwargs):
     return subprocess.run(*args, check=True, **kwargs)
 
 
-def run_no_venv(*args, **kwargs):
-    env = os.environ.copy()
-    virtual_env = env.pop('VIRTUAL_ENV', None)
-    if virtual_env:
-        env['PATH'] = ':'.join(
-            p for p in env['PATH'].split(':') if not p.startswith(virtual_env)
-        )
-    return run(*args, env=env, **kwargs)
-
-
 def run_tox():
-    run_no_venv('tox -p all', shell=True)
+    run('tox -p all', shell=True)
 
 
 def path_sub(pattern, repl, path):

{reader-3.26 → reader-3.27}/src/reader/__init__.py

@@ -37,7 +37,7 @@ Print the titles of the unread entries::
 
 """
 
-__version__ = '3.26'
+__version__ = '3.27'
 
 # isort: off
 

{reader-3.26 → reader-3.27}/src/reader/_cli.py

@@ -169,6 +169,11 @@ class MapParamType(click.ParamType):
     ),
 )
 @click.option('--read-only/--no-read-only', help="Do not modify storage.")
+@click.option(
+    '--migrate/--no-migrate',
+    default=True,
+    help="Enable or disable automatic schema migrations (default: enabled).",
+)
 @click.option(
     '--plugin',
     'plugins',
@@ -202,7 +207,9 @@ class MapParamType(click.ParamType):
 )
 @click.version_option(reader.__version__, message='%(prog)s %(version)s')
 @click.pass_context
-def cli(ctx, url, feed_root, read_only, plugins, cli_plugins, reserved_name_scheme):
+def cli(
+    ctx, url, feed_root, read_only, migrate, plugins, cli_plugins, reserved_name_scheme
+):
     """reader command-line interface.
 
     Option defaults can be set via environment variables;