webchanges 3.26.0__tar.gz → 3.28.0rc0__tar.gz

{webchanges-3.26.0 → webchanges-3.28.0rc0}/LICENSE

@@ -28,7 +28,7 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 SOURCE CODE REDISTRIBUTION NOTICE
 (urlwatch by Thomas Perl)
 
-This software redistributes source code of release 2.21 dated 30 July 2020 of
+This software redistributes source code of release 2.21, dated 30 July 2020, of
 urlwatch
 https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f,
 which is subject to the following copyright notice and license (from

{webchanges-3.26.0/webchanges.egg-info → webchanges-3.28.0rc0}/PKG-INFO

@@ -1,7 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: webchanges
-Version: 3.26.0
-Summary: Check web (or command output) for changes since last run and notify. Anonymously alerts you of web changes, with
+Version: 3.28.0rc0
+Summary: Web Changes Delivered. AI-Summarized. Totally Anonymous.
 Author-email: Mike Borsetti <mike+webchanges@borsetti.com>
 Maintainer-email: Mike Borsetti <mike+webchanges@borsetti.com>
 License: ========
@@ -34,7 +34,7 @@ License: ========
         SOURCE CODE REDISTRIBUTION NOTICE
         (urlwatch by Thomas Perl)
         
-        This software redistributes source code of release 2.21 dated 30 July 2020 of
+        This software redistributes source code of release 2.21, dated 30 July 2020, of
         urlwatch
         https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f,
         which is subject to the following copyright notice and license (from
@@ -103,17 +103,18 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
-Requires-Dist: colorama; os_name == "nt"
+Requires-Dist: colorama; sys_platform == "win32"
 Requires-Dist: cssselect
 Requires-Dist: h2
 Requires-Dist: html2text
 Requires-Dist: httpx
-Requires-Dist: lxml
+Requires-Dist: lxml>=5.3.0
 Requires-Dist: markdown2
 Requires-Dist: msgpack
 Requires-Dist: platformdirs
 Requires-Dist: pyyaml
-Requires-Dist: tzdata; os_name == "nt"
+Requires-Dist: tzdata; sys_platform == "win32"
+Requires-Dist: zstandard
 Provides-Extra: use-browser
 Requires-Dist: playwright; extra == "use-browser"
 Requires-Dist: psutil; extra == "use-browser"
@@ -160,10 +161,8 @@ Provides-Extra: requests
 Requires-Dist: requests; extra == "requests"
 Provides-Extra: safe-password
 Requires-Dist: keyring; extra == "safe-password"
-Provides-Extra: zstd
-Requires-Dist: zstandard; extra == "zstd"
 Provides-Extra: all
-Requires-Dist: webchanges[beautify,bs4,deepdiff_xml,html5lib,ical2text,imagediff,jq,matrix,ocr,pdf2text,pushbullet,pushover,pypdf_crypto,redis,requests,safe_password,use_browser,xmpp,zstd]; extra == "all"
+Requires-Dist: webchanges[beautify,bs4,deepdiff_xml,html5lib,ical2text,imagediff,jq,matrix,ocr,pdf2text,pushbullet,pushover,pypdf_crypto,redis,requests,safe_password,use_browser,xmpp]; extra == "all"
 
 .. role:: underline
     :class: underline
@@ -176,22 +175,18 @@ Requires-Dist: webchanges[beautify,bs4,deepdiff_xml,html5lib,ical2text,imagediff
 webchanges |downloads|
 ======================
 
-**webchanges** checks web content including images, and notifies you via email (or one of many other `supported
-services <https://webchanges.readthedocs.io/en/stable/introduction.html#reporters-list>`__) if a change is detected.
-**webchanges** can also check the output of local commands. The notification includes a detail of what has changed
-("diff"), with an optional summary generated by AI (BETA).
-
-**webchanges** *anonymously* alerts you of web changes.
-
+**webchanges** *anonymously* checks web content (including images) and commands for changes, delivering instant
+notifications and AI-powered summaries to your favorite `platform
+<https://webchanges.readthedocs.io/en/stable/introduction.html#reporters-list>`__.
 
 
 Requirements
 ============
 **webchanges** requires |support|.
 
-You should use the latest version of `Python <https://www.python.org/downloads/>`__ if possible, but older
-Python versions are supported for 3 years after being obsoleted by a new major release (3.x). For each major release,
-only the latest bug and security fix version (3.x.y) is supported.
+For the best experience, use the current version of `Python <https://www.python.org/downloads/>`__. We also support
+older Python versions for 3 years after they're replaced by a newer one; we just ask that you use the most up-to-date
+bug and security fix release from that older version.
 
 For Generative AI summaries (BETA), you need a free `API Key from Google Cloud AI Studio
 <https://aistudio.google.com/app/apikey>`__ (see `here
@@ -206,11 +201,10 @@ Install **webchanges** |pypi_version| |format| |status| |security| with:
 
    pip install webchanges
 
-
 Running in Docker
-=================
-**webchanges** can be run in a `Docker <https://www.docker.com/>`__ container; please see `here
-<https://github.com/yubiuser/webchanges-docker>`__ for one such implementation.
+-----------------
+**webchanges** can easily run in a container; you can find a `Docker <https://www.docker.com/>`__ implementation
+`here <https://github.com/yubiuser/webchanges-docker>`__.
 
 
 Documentation |readthedocs|
@@ -230,7 +224,6 @@ Initialize
 
       webchanges --edit
 
-
 #. Run the following command to change the default `configuration
    <https://webchanges.readthedocs.io/en/stable/configuration.html>`__, e.g. to receive change notifications
    ("`reports <https://webchanges.readthedocs.io/en/stable/reporters.html>`__")
@@ -240,26 +233,27 @@ Initialize
 
       webchanges --edit-config
 
-
 Run
 ---
-To check the sources in your jobs and report on (e.g. display or via email) any changes found from the previous
-execution, just run:
+To check the sources in your jobs and report on (e.g. display or via email) any changes found from the last time the
+program ran, just run:
 
 .. code-block:: bash
 
    webchanges
 
-**webchanges** does not include a scheduler. We recommend using a system scheduler to automatically run it
-periodically:
 
-- On Linux or macOS, you can use cron (if you have never used cron before, see
-  `here <https://www.computerhope.com/unix/ucrontab.htm>`__); `crontab.guru <https://crontab.guru>`__ will build a
-  schedule expression for you;
-- On macOS, you can use `launchd <https://developer.apple
-  .com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/ScheduledJobs.html>`__;
-- On Windows, you can use the built-in `Windows Task Scheduler
-  <https://en.wikipedia.org/wiki/Windows_Task_Scheduler>`__.
+Schedule
+--------
+**webchanges** leverages the power of a system scheduler:
+
+- On Linux you can use cron, and a tool like `crontab.guru <https://crontab.guru>`__ can build a
+  schedule expression for you (note: see `here <https://www.computerhope.com/unix/ucrontab.htm>`__ if you have never
+  used cron before);
+- On Windows you can use `Windows Task Scheduler <https://en.wikipedia.org/wiki/Windows_Task_Scheduler>`__;
+- On macOS you can use `launchd <https://developer.apple
+  .com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/ScheduledJobs.html>`__ (note: see `here
+  <https://launchd.info/>`__ if you have never used launchd before).
 
 
 Code
@@ -283,42 +277,50 @@ License
 =======
 |license|
 
-Released under the `MIT License <https://opensource.org/licenses/MIT>`__ but redistributing modified source code from
-`urlwatch 2.21 <https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__ dated 30 July 2020
+See the `complete licenses <https://raw.githubusercontent.com/mborsetti/webchanges/refs/heads/main/LICENSE>`__ (released
+under the `MIT License <https://opensource.org/licenses/MIT>`__ but redistributing modified source code, dated 30
+July 2020, from `urlwatch 2.21 <https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__
 licensed under a `BSD 3-Clause License
-<https://raw.githubusercontent.com/thp/urlwatch/346b25914b0418342ffe2fb0529bed702fddc01f/COPYING>`__. See the complete
-license `here <https://github.com/mborsetti/webchanges/blob/main/LICENSE>`__.
+<https://raw.githubusercontent.com/thp/urlwatch/346b25914b0418342ffe2fb0529bed702fddc01f/COPYING>`__).
 
 
 Compatibility with and improvements from **urlwatch**
 =====================================================
 
 This project is based on code from `urlwatch 2.21
-<https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__ dated 30 July 2020. You can
-easily upgrade to **webchanges** from the current version of **urlwatch** using the same job and configuration files
-(see `here <https://webchanges.readthedocs.io/en/stable/migration.html>`__) and benefit from many improvements,
-including:
-
-* Summary of changes in plain text using Generative AI, useful for long documents (e.g. legal);
-* Depicting changes to an image;
-* Element-by-element changes of JSON or XML data;
-* Much better `documentation <https://webchanges.readthedocs.io/>`__, easing implementation;
-* Much clearer to HTML reports, which include:
-
-  * Links that are `clickable <https://pypi.org/project/webchanges/>`__!
-  * Retaining of original formatting such as **bolding / headers**, *italics*, :underline:`underlining`, list bullets
-    (•) and indentation;
-  * Lines that are :additions:`added` and :deletions:`deleted` are clearly highlighted by color and strikethrough,
-    and long lines wrap around;
-  * Correct rendering by email clients who override stylesheets (e.g. Gmail);
-  * Other legibility improvements;
-
-* New filters such as `additions_only <https://webchanges.readthedocs.io/en/stable/diff_filters.html#additions-only>`__,
-  which makes it easier to track content that was added without the distractions of the content that was deleted;
-* New command line arguments, such as ``--errors`` (to catch jobs that no longer work);
-* More reliability and stability, including a ~30 percentage point increase in testing coverage;
-* Many other additions, refinements and fixes (see `detailed information
-  <https://webchanges.readthedocs.io/en/stable/migration.html#upgrade-details>`__).
+<https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__ dated 30 July 2020.
+
+You can easily upgrade to **webchanges** from the current version of **urlwatch** using the same job and
+configuration files (see `here <https://webchanges.readthedocs.io/en/stable/upgrading.html>`__) and benefit from many
+improvements, including:
+
+* :underline:`AI-Powered Summaries`: Summary of changes in plain text using generative AI, useful for long documents
+  (e.g. legal);
+* :underline:`Image Change Detection`: Monitor changes to images and receive notifications with an image highlighting
+  the differences;
+* :underline:`Structured Data Monitoring`: Track changes in JSON or XML data on an element-by-element basis;
+* :underline:`Improved Documentation`: We've revamped the `documentation <https://webchanges.readthedocs.io/>`__ to make
+  implementation easier;
+* :underline:`Enhanced HTML Reports`: HTML reports are now much clearer and include:
+
+  * Clickable links!
+  * Retention of most original formatting (**bolding / headers**, *italics*, :underline:`underlining`, lists with
+    bullets (•), and indentation;
+  * :additions:`added` and :deletions:`deleted` lines clearly highlighted with color and strikethrough;
+  * Wrapping of long lines (instead of truncation);
+  * Improved compatibility with a wider range of HTML email clients, including those that override stylesheets (e.g.,
+    Gmail);
+  * General legibility improvements.
+
+* :underline:`New Filtering Options`: New filters, like `additions_only
+  <https://webchanges.readthedocs.io/en/stable/diff_filters.html#additions-only>`__, which allows you to focus on
+  added content without the distraction of deletions;
+* :underline:`New Command Line Arguments`: New command-line arguments such as ``--errors``, which helps you identify
+  jobs that are no longer functioning correctly;
+* :underline:`Increased Reliability and Stability`: Testing coverage has increased by approximately 30 percentage
+  points;
+* :underline:`Additional Enhancements`: Numerous other additions, refinements, and bug fixes have been implemented.
+  For more information, see `here <https://webchanges.readthedocs.io/en/stable/migration.html#upgrade-details>`__.
 
 Example enhancements to HTML reporting:
 

{webchanges-3.26.0 → webchanges-3.28.0rc0}/README.rst

@@ -9,22 +9,18 @@
 webchanges |downloads|
 ======================
 
-**webchanges** checks web content including images, and notifies you via email (or one of many other `supported
-services <https://webchanges.readthedocs.io/en/stable/introduction.html#reporters-list>`__) if a change is detected.
-**webchanges** can also check the output of local commands. The notification includes a detail of what has changed
-("diff"), with an optional summary generated by AI (BETA).
-
-**webchanges** *anonymously* alerts you of web changes.
-
+**webchanges** *anonymously* checks web content (including images) and commands for changes, delivering instant
+notifications and AI-powered summaries to your favorite `platform
+<https://webchanges.readthedocs.io/en/stable/introduction.html#reporters-list>`__.
 
 
 Requirements
 ============
 **webchanges** requires |support|.
 
-You should use the latest version of `Python <https://www.python.org/downloads/>`__ if possible, but older
-Python versions are supported for 3 years after being obsoleted by a new major release (3.x). For each major release,
-only the latest bug and security fix version (3.x.y) is supported.
+For the best experience, use the current version of `Python <https://www.python.org/downloads/>`__. We also support
+older Python versions for 3 years after they're replaced by a newer one; we just ask that you use the most up-to-date
+bug and security fix release from that older version.
 
 For Generative AI summaries (BETA), you need a free `API Key from Google Cloud AI Studio
 <https://aistudio.google.com/app/apikey>`__ (see `here
@@ -39,11 +35,10 @@ Install **webchanges** |pypi_version| |format| |status| |security| with:
 
    pip install webchanges
 
-
 Running in Docker
-=================
-**webchanges** can be run in a `Docker <https://www.docker.com/>`__ container; please see `here
-<https://github.com/yubiuser/webchanges-docker>`__ for one such implementation.
+-----------------
+**webchanges** can easily run in a container; you can find a `Docker <https://www.docker.com/>`__ implementation
+`here <https://github.com/yubiuser/webchanges-docker>`__.
 
 
 Documentation |readthedocs|
@@ -63,7 +58,6 @@ Initialize
 
       webchanges --edit
 
-
 #. Run the following command to change the default `configuration
    <https://webchanges.readthedocs.io/en/stable/configuration.html>`__, e.g. to receive change notifications
    ("`reports <https://webchanges.readthedocs.io/en/stable/reporters.html>`__")
@@ -73,26 +67,27 @@ Initialize
 
       webchanges --edit-config
 
-
 Run
 ---
-To check the sources in your jobs and report on (e.g. display or via email) any changes found from the previous
-execution, just run:
+To check the sources in your jobs and report on (e.g. display or via email) any changes found from the last time the
+program ran, just run:
 
 .. code-block:: bash
 
    webchanges
 
-**webchanges** does not include a scheduler. We recommend using a system scheduler to automatically run it
-periodically:
 
-- On Linux or macOS, you can use cron (if you have never used cron before, see
-  `here <https://www.computerhope.com/unix/ucrontab.htm>`__); `crontab.guru <https://crontab.guru>`__ will build a
-  schedule expression for you;
-- On macOS, you can use `launchd <https://developer.apple
-  .com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/ScheduledJobs.html>`__;
-- On Windows, you can use the built-in `Windows Task Scheduler
-  <https://en.wikipedia.org/wiki/Windows_Task_Scheduler>`__.
+Schedule
+--------
+**webchanges** leverages the power of a system scheduler:
+
+- On Linux you can use cron, and a tool like `crontab.guru <https://crontab.guru>`__ can build a
+  schedule expression for you (note: see `here <https://www.computerhope.com/unix/ucrontab.htm>`__ if you have never
+  used cron before);
+- On Windows you can use `Windows Task Scheduler <https://en.wikipedia.org/wiki/Windows_Task_Scheduler>`__;
+- On macOS you can use `launchd <https://developer.apple
+  .com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/ScheduledJobs.html>`__ (note: see `here
+  <https://launchd.info/>`__ if you have never used launchd before).
 
 
 Code
@@ -116,42 +111,50 @@ License
 =======
 |license|
 
-Released under the `MIT License <https://opensource.org/licenses/MIT>`__ but redistributing modified source code from
-`urlwatch 2.21 <https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__ dated 30 July 2020
+See the `complete licenses <https://raw.githubusercontent.com/mborsetti/webchanges/refs/heads/main/LICENSE>`__ (released
+under the `MIT License <https://opensource.org/licenses/MIT>`__ but redistributing modified source code, dated 30
+July 2020, from `urlwatch 2.21 <https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__
 licensed under a `BSD 3-Clause License
-<https://raw.githubusercontent.com/thp/urlwatch/346b25914b0418342ffe2fb0529bed702fddc01f/COPYING>`__. See the complete
-license `here <https://github.com/mborsetti/webchanges/blob/main/LICENSE>`__.
+<https://raw.githubusercontent.com/thp/urlwatch/346b25914b0418342ffe2fb0529bed702fddc01f/COPYING>`__).
 
 
 Compatibility with and improvements from **urlwatch**
 =====================================================
 
 This project is based on code from `urlwatch 2.21
-<https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__ dated 30 July 2020. You can
-easily upgrade to **webchanges** from the current version of **urlwatch** using the same job and configuration files
-(see `here <https://webchanges.readthedocs.io/en/stable/migration.html>`__) and benefit from many improvements,
-including:
-
-* Summary of changes in plain text using Generative AI, useful for long documents (e.g. legal);
-* Depicting changes to an image;
-* Element-by-element changes of JSON or XML data;
-* Much better `documentation <https://webchanges.readthedocs.io/>`__, easing implementation;
-* Much clearer to HTML reports, which include:
-
-  * Links that are `clickable <https://pypi.org/project/webchanges/>`__!
-  * Retaining of original formatting such as **bolding / headers**, *italics*, :underline:`underlining`, list bullets
-    (•) and indentation;
-  * Lines that are :additions:`added` and :deletions:`deleted` are clearly highlighted by color and strikethrough,
-    and long lines wrap around;
-  * Correct rendering by email clients who override stylesheets (e.g. Gmail);
-  * Other legibility improvements;
-
-* New filters such as `additions_only <https://webchanges.readthedocs.io/en/stable/diff_filters.html#additions-only>`__,
-  which makes it easier to track content that was added without the distractions of the content that was deleted;
-* New command line arguments, such as ``--errors`` (to catch jobs that no longer work);
-* More reliability and stability, including a ~30 percentage point increase in testing coverage;
-* Many other additions, refinements and fixes (see `detailed information
-  <https://webchanges.readthedocs.io/en/stable/migration.html#upgrade-details>`__).
+<https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__ dated 30 July 2020.
+
+You can easily upgrade to **webchanges** from the current version of **urlwatch** using the same job and
+configuration files (see `here <https://webchanges.readthedocs.io/en/stable/upgrading.html>`__) and benefit from many
+improvements, including:
+
+* :underline:`AI-Powered Summaries`: Summary of changes in plain text using generative AI, useful for long documents
+  (e.g. legal);
+* :underline:`Image Change Detection`: Monitor changes to images and receive notifications with an image highlighting
+  the differences;
+* :underline:`Structured Data Monitoring`: Track changes in JSON or XML data on an element-by-element basis;
+* :underline:`Improved Documentation`: We've revamped the `documentation <https://webchanges.readthedocs.io/>`__ to make
+  implementation easier;
+* :underline:`Enhanced HTML Reports`: HTML reports are now much clearer and include:
+
+  * Clickable links!
+  * Retention of most original formatting (**bolding / headers**, *italics*, :underline:`underlining`, lists with
+    bullets (•), and indentation;
+  * :additions:`added` and :deletions:`deleted` lines clearly highlighted with color and strikethrough;
+  * Wrapping of long lines (instead of truncation);
+  * Improved compatibility with a wider range of HTML email clients, including those that override stylesheets (e.g.,
+    Gmail);
+  * General legibility improvements.
+
+* :underline:`New Filtering Options`: New filters, like `additions_only
+  <https://webchanges.readthedocs.io/en/stable/diff_filters.html#additions-only>`__, which allows you to focus on
+  added content without the distraction of deletions;
+* :underline:`New Command Line Arguments`: New command-line arguments such as ``--errors``, which helps you identify
+  jobs that are no longer functioning correctly;
+* :underline:`Increased Reliability and Stability`: Testing coverage has increased by approximately 30 percentage
+  points;
+* :underline:`Additional Enhancements`: Numerous other additions, refinements, and bug fixes have been implemented.
+  For more information, see `here <https://webchanges.readthedocs.io/en/stable/migration.html#upgrade-details>`__.
 
 Example enhancements to HTML reporting:
 

{webchanges-3.26.0 → webchanges-3.28.0rc0}/pyproject.toml

@@ -14,10 +14,7 @@ build-backend = "setuptools.build_meta"
 # See https://packaging.python.org/en/latest/specifications/declaring-project-metadata/
 dynamic = ['version', 'dependencies']
 name = 'webchanges'
-description = """\
-    Check web (or command output) for changes since last run and notify. Anonymously alerts you of web changes, with
-    Gen AI summaries (BETA).\
-    """
+description = 'Web Changes Delivered. AI-Summarized. Totally Anonymous.'
 readme = { file = 'README.rst', content-type = 'text/x-rst' }
 requires-python = '>=3.10'
 license = {file = 'LICENSE'}
@@ -93,9 +90,8 @@ xmpp = ['aioxmpp']
 redis = ['redis']
 requests = ['requests']
 safe_password = ['keyring']
-zstd = ['zstandard']
 all = [
-    'webchanges[use_browser,beautify,bs4,html5lib,ical2text,jq,ocr,pdf2text,pypdf_crypto,deepdiff_xml,imagediff,matrix,pushbullet,pushover,xmpp,redis,requests,safe_password,zstd]'
+    'webchanges[use_browser,beautify,bs4,html5lib,ical2text,jq,ocr,pdf2text,pypdf_crypto,deepdiff_xml,imagediff,matrix,pushbullet,pushover,xmpp,redis,requests,safe_password]'
 ]
 
 
@@ -177,9 +173,6 @@ namespace_packages = false
 # Specifies the Python version used to parse and check the target program.
 # python_version = 3.12
 
-# Shows error codes in error messages.
-show_error_codes = true
-
 # Suppresses error messages about imports that cannot be resolved.
 ignore_missing_imports = true
 
@@ -192,22 +185,25 @@ disallow_untyped_defs = true
 # Reports an error whenever a function with type annotations is decorated with a decorator without annotations.
 disallow_untyped_decorators = true
 
-# Changes the treatment of arguments with a default value of None by not implicitly making their type Optional.
-no_implicit_optional = true
-
 # Warns about casting an expression to its inferred type.
 warn_redundant_casts = true
 
 # Warns about unneeded # type: ignore comments.
-# Disabled because it behaves differently in GitHub Actions than it does on Windows.
+# May behave differently in GitHub Actions than it does on Windows.
 # warn_unused_ignores = true
 
 # Shows a warning when returning a value with type Any from a function declared with a non-Any return type.
-# warn_return_any = true
+warn_return_any = true
 
 # Shows a warning when encountering any code inferred to be unreachable or redundant after performing type analysis.
 warn_unreachable = false
 
+# Enables additional checks that are technically correct but may be impractical in real code.
+extra_checks = true
+
+# Shows documentation link to corresponding error code.
+show_error_code_links = true
+
 # Use visually nicer output in error messages: use soft word wrap, show source code snippets, and show error location
 # markers.
 pretty = true
@@ -299,6 +295,8 @@ exclude_lines = [
     # Don't cover IDE code:
     'if TYPE_CHECKING:'
 ]
+# Exclude entire files if they have a custom # pragma: exclude file remark
+# exclude_also = '(?s)\A.*# pragma: exclude file.*\Z'
 # ignore_errors = true
 
 

webchanges-3.28.0rc0/requirements.txt

@@ -0,0 +1,12 @@
+colorama; sys_platform == "win32"
+cssselect
+h2
+html2text
+httpx
+lxml >= 5.3.0  # prior versions don't build in 3.13
+markdown2
+msgpack
+platformdirs
+pyyaml
+tzdata; sys_platform == "win32"
+zstandard

{webchanges-3.26.0 → webchanges-3.28.0rc0}/webchanges/__init__.py

@@ -22,7 +22,7 @@ __project_name__ = __package__
 # * MINOR version when you add functionality in a backwards compatible manner, and
 # * MICRO or PATCH version when you make backwards compatible bug fixes. We no longer use '0'
 # If unsure on increments, use pkg_resources.parse_version to parse
-__version__ = '3.26.0'
+__version__ = '3.28.0rc0'
 __description__ = (
     'Check web (or command output) for changes since last run and notify.\n'
     '\n'

{webchanges-3.26.0 → webchanges-3.28.0rc0}/webchanges/_vendored/headers.py

@@ -208,9 +208,9 @@ class Headers(MutableMapping[str, str]):
         if not split_commas:
             return values
 
-        split_values = []
+        split_values: list[str] = []
         for value in values:
-            split_values.extend([item.strip() for item in value.split(',')])
+            split_values.extend((item.strip() for item in value.split(',')))
         return split_values
 
     def update(self, headers: HeaderTypes | None = None) -> None:  # type: ignore[override]

{webchanges-3.26.0 → webchanges-3.28.0rc0}/webchanges/cli.py

@@ -78,12 +78,20 @@ def migrate_from_legacy(
             logger.warning(f"You can safely delete '{old_file}'.")
 
 
-def setup_logger(verbose: int | None = None) -> None:
+def setup_logger(verbose: int | None = None, log_file: Path | None = None) -> None:
     """Set up the logger.
 
-    :param verbose: the verbosity level (1 = INFO, 2 = ERROR).
+    :param verbose: the verbosity level (1 = INFO, 2 = ERROR, 3 = NOTSET).
     """
+    if log_file:
+        handlers: tuple[logging.Handler, ...] | None = (logging.FileHandler(log_file),)
+        if not verbose:
+            verbose = 1
+    else:
+        handlers = None
+
     log_level = None
+
     if verbose is not None:
         if verbose >= 3:
             log_level = 'NOTSET'
@@ -99,7 +107,11 @@ def setup_logger(verbose: int | None = None) -> None:
     if not verbose:
         sys.tracebacklimit = 0
 
-    logging.basicConfig(format='%(asctime)s %(module)s[%(thread)s] %(levelname)s: %(message)s', level=log_level)
+    logging.basicConfig(
+        format='%(asctime)s %(module)s[%(thread)s] %(levelname)s: %(message)s',
+        level=log_level,
+        handlers=handlers,
+    )
     logger.info(f'{__project_name__}: {__version__} {__copyright__}')
     logger.info(
         f'{platform.python_implementation()}: {platform.python_version()} '
@@ -358,7 +370,7 @@ def main() -> None:  # pragma: no cover
     )
 
     # Set up the logger to verbose if needed
-    setup_logger(command_config.verbose)
+    setup_logger(command_config.verbose, command_config.log_file)
 
     # For speed, run these here
     handle_unitialized_actions(command_config)