webchanges 3.28.1__tar.gz → 3.29.0__tar.gz

{webchanges-3.28.1/webchanges.egg-info → webchanges-3.29.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: webchanges
-Version: 3.28.1
+Version: 3.29.0
 Summary: Web Changes Delivered. AI-Summarized. Totally Anonymous.
 Author-email: Mike Borsetti <mike+webchanges@borsetti.com>
 Maintainer-email: Mike Borsetti <mike+webchanges@borsetti.com>
@@ -163,6 +163,7 @@ Provides-Extra: safe-password
 Requires-Dist: keyring; extra == "safe-password"
 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]; extra == "all"
+Dynamic: license-file
 
 .. role:: underline
     :class: underline
@@ -195,7 +196,9 @@ For Generative AI summaries (BETA), you need a free `API Key from Google Cloud A
 
 Installation
 ============
-Install **webchanges** |pypi_version| |format| |status| |security| with:
+|pypi_version| |format| |status| |security|
+
+Install **webchanges**  with:
 
 .. code-block:: bash
 
@@ -203,7 +206,7 @@ Install **webchanges** |pypi_version| |format| |status| |security| with:
 
 Running in Docker
 -----------------
-**webchanges** can easily run in a container; you can find a `Docker <https://www.docker.com/>`__ implementation
+**webchanges** can easily run in a container and you will find a `Docker <https://www.docker.com/>`__ implementation
 `here <https://github.com/yubiuser/webchanges-docker>`__.
 
 
@@ -247,20 +250,19 @@ 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 Linux you can use cron, with the help of a tool like `crontab.guru <https://crontab.guru>`__ (help `here
+  <https://www.computerhope.com/unix/ucrontab.htm>`__);
 - 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).
+  .com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/ScheduledJobs.html>`__ (help `here
+  <https://launchd.info/>`__).
 
 
 Code
 ====
-|coveralls| |issues|
+|coveralls| |issues| |code_style|
 
-The code and issues tracker are hosted on `GitHub <https://github.com/mborsetti/webchanges>`__.
+The code, issues tracker, and discussions are hosted on `GitHub <https://github.com/mborsetti/webchanges>`__.
 
 
 Contributing
@@ -344,7 +346,7 @@ Example enhancements to HTML reporting:
 .. |format| image:: https://img.shields.io/pypi/format/webchanges.svg
     :target: https://pypi.org/project/webchanges/
     :alt: Kit format
-.. |downloads| image:: https://static.pepy.tech/badge/webchanges
+.. |downloads| image:: https://img.shields.io/pypi/dm/webchanges.svg
     :target: https://www.pepy.tech/project/webchanges
     :alt: PyPI downloads
 .. |license| image:: https://img.shields.io/pypi/l/webchanges.svg
@@ -356,15 +358,24 @@ Example enhancements to HTML reporting:
 .. |readthedocs| image:: https://img.shields.io/readthedocs/webchanges/stable.svg?label=
     :target: https://webchanges.readthedocs.io/
     :alt: Documentation status
-.. |CI| image:: https://github.com/mborsetti/webchanges/actions/workflows/ci-cd.yaml/badge.svg?event=push
+.. |old_CI| image:: https://github.com/mborsetti/webchanges/actions/workflows/ci-cd.yaml/badge.svg?event=push
+    :target: https://github.com/mborsetti/webchanges/actions
+    :alt: CI testing status
+.. |CI| image:: https://img.shields.io/github/check-runs/mborsetti/webchanges/main
     :target: https://github.com/mborsetti/webchanges/actions
     :alt: CI testing status
-.. |coveralls| image:: https://coveralls.io/repos/github/mborsetti/webchanges/badge.svg?branch=main
+.. |old_coveralls| image:: https://coveralls.io/repos/github/mborsetti/webchanges/badge.svg?branch=main
+    :target: https://coveralls.io/github/mborsetti/webchanges?branch=main
+    :alt: Code coverage by Coveralls
+.. |coveralls| image:: https://img.shields.io/coverallsCoverage/github/mborsetti/webchanges.svg
     :target: https://coveralls.io/github/mborsetti/webchanges?branch=main
     :alt: Code coverage by Coveralls
+.. |code_style| image:: https://img.shields.io/badge/code%20style-black-000000.svg
+    :target: https://github.com/psf/black
+    :alt: Code style black
 .. |status| image:: https://img.shields.io/pypi/status/webchanges.svg
     :target: https://pypi.org/project/webchanges/
     :alt: Package stability
-.. |security| image:: https://img.shields.io/badge/security-bandit-yellow.svg
+.. |security| image:: https://img.shields.io/badge/security-bandit-green.svg
     :target: https://github.com/PyCQA/bandit
     :alt: Security Status

{webchanges-3.28.1 → webchanges-3.29.0}/README.rst

@@ -29,7 +29,9 @@ For Generative AI summaries (BETA), you need a free `API Key from Google Cloud A
 
 Installation
 ============
-Install **webchanges** |pypi_version| |format| |status| |security| with:
+|pypi_version| |format| |status| |security|
+
+Install **webchanges**  with:
 
 .. code-block:: bash
 
@@ -37,7 +39,7 @@ Install **webchanges** |pypi_version| |format| |status| |security| with:
 
 Running in Docker
 -----------------
-**webchanges** can easily run in a container; you can find a `Docker <https://www.docker.com/>`__ implementation
+**webchanges** can easily run in a container and you will find a `Docker <https://www.docker.com/>`__ implementation
 `here <https://github.com/yubiuser/webchanges-docker>`__.
 
 
@@ -81,20 +83,19 @@ 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 Linux you can use cron, with the help of a tool like `crontab.guru <https://crontab.guru>`__ (help `here
+  <https://www.computerhope.com/unix/ucrontab.htm>`__);
 - 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).
+  .com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/ScheduledJobs.html>`__ (help `here
+  <https://launchd.info/>`__).
 
 
 Code
 ====
-|coveralls| |issues|
+|coveralls| |issues| |code_style|
 
-The code and issues tracker are hosted on `GitHub <https://github.com/mborsetti/webchanges>`__.
+The code, issues tracker, and discussions are hosted on `GitHub <https://github.com/mborsetti/webchanges>`__.
 
 
 Contributing
@@ -178,7 +179,7 @@ Example enhancements to HTML reporting:
 .. |format| image:: https://img.shields.io/pypi/format/webchanges.svg
     :target: https://pypi.org/project/webchanges/
     :alt: Kit format
-.. |downloads| image:: https://static.pepy.tech/badge/webchanges
+.. |downloads| image:: https://img.shields.io/pypi/dm/webchanges.svg
     :target: https://www.pepy.tech/project/webchanges
     :alt: PyPI downloads
 .. |license| image:: https://img.shields.io/pypi/l/webchanges.svg
@@ -190,15 +191,24 @@ Example enhancements to HTML reporting:
 .. |readthedocs| image:: https://img.shields.io/readthedocs/webchanges/stable.svg?label=
     :target: https://webchanges.readthedocs.io/
     :alt: Documentation status
-.. |CI| image:: https://github.com/mborsetti/webchanges/actions/workflows/ci-cd.yaml/badge.svg?event=push
+.. |old_CI| image:: https://github.com/mborsetti/webchanges/actions/workflows/ci-cd.yaml/badge.svg?event=push
+    :target: https://github.com/mborsetti/webchanges/actions
+    :alt: CI testing status
+.. |CI| image:: https://img.shields.io/github/check-runs/mborsetti/webchanges/main
     :target: https://github.com/mborsetti/webchanges/actions
     :alt: CI testing status
-.. |coveralls| image:: https://coveralls.io/repos/github/mborsetti/webchanges/badge.svg?branch=main
+.. |old_coveralls| image:: https://coveralls.io/repos/github/mborsetti/webchanges/badge.svg?branch=main
+    :target: https://coveralls.io/github/mborsetti/webchanges?branch=main
+    :alt: Code coverage by Coveralls
+.. |coveralls| image:: https://img.shields.io/coverallsCoverage/github/mborsetti/webchanges.svg
     :target: https://coveralls.io/github/mborsetti/webchanges?branch=main
     :alt: Code coverage by Coveralls
+.. |code_style| image:: https://img.shields.io/badge/code%20style-black-000000.svg
+    :target: https://github.com/psf/black
+    :alt: Code style black
 .. |status| image:: https://img.shields.io/pypi/status/webchanges.svg
     :target: https://pypi.org/project/webchanges/
     :alt: Package stability
-.. |security| image:: https://img.shields.io/badge/security-bandit-yellow.svg
+.. |security| image:: https://img.shields.io/badge/security-bandit-green.svg
     :target: https://github.com/PyCQA/bandit
     :alt: Security Status

{webchanges-3.28.1 → webchanges-3.29.0}/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.28.1'
+__version__ = '3.29.0'
 __description__ = (
     'Check web (or command output) for changes since last run and notify.\n'
     '\n'

webchanges-3.29.0/webchanges/__main__.py

@@ -0,0 +1,10 @@
+import sys
+from pathlib import Path
+
+parent_dir = Path(__file__).parent.parent
+sys.path.insert(1, str(parent_dir))
+
+if __name__ == '__main__':
+    from cli import main
+
+    main()

{webchanges-3.28.1 → webchanges-3.29.0}/webchanges/cli.py

@@ -244,19 +244,18 @@ def first_run(command_config: CommandConfig) -> None:
 def load_hooks(hooks_file: Path) -> None:
     """Load hooks file."""
     if not hooks_file.is_file():
-        warnings.warn(
-            f'Hooks file not imported because {hooks_file} is not a file',
-            ImportWarning,
-        )
+        # do not use ImportWarning as it could be suppressed
+        warnings.warn(f'Hooks file not imported because {hooks_file} is not a file', RuntimeWarning)
         return
 
     hooks_file_errors = file_ownership_checks(hooks_file)
     if hooks_file_errors:
+        logger.debug('Here should come the warning')
+        # do not use ImportWarning as it could be suppressed
         warnings.warn(
-            f'Hooks file {hooks_file} not imported because '
-            f" {' and '.join(hooks_file_errors)}.\n"
+            f"Hooks file {hooks_file} not not imported because{' and '.join(hooks_file_errors)}.\n"
             f'(see {__docs_url__}en/stable/hooks.html#important-note-for-hooks-file)',
-            ImportWarning,
+            RuntimeWarning,
         )
     else:
         logger.info(f'Importing hooks module from {hooks_file}')
@@ -372,6 +371,10 @@ def main() -> None:  # pragma: no cover
     # Set up the logger to verbose if needed
     setup_logger(command_config.verbose, command_config.log_file)
 
+    # log defaults
+    logger.debug(f'Default config path is {config_path}')
+    logger.debug(f'Default data path is {data_path}')
+
     # For speed, run these here
     handle_unitialized_actions(command_config)
 
@@ -401,6 +404,7 @@ def main() -> None:  # pragma: no cover
 
     # load config (which for syntax checking requires hooks to be loaded too)
     if command_config.hooks_files:
+        logger.debug(f'Hooks files to be loaded: {command_config.hooks_files}')
         for hooks_file in command_config.hooks_files:
             load_hooks(hooks_file)
     config_storage.load()

{webchanges-3.28.1 → webchanges-3.29.0}/webchanges/command.py

@@ -498,8 +498,8 @@ class UrlwatchCommand:
 
     def test_differ(self, arg_test_differ: list[str]) -> int:
         """
-        Runs diffs for a job on all the saved snapshots and outputs the result to stdout or whatever reporter is
-        selected with --test-reporter.
+        Runs diffs for a job on all the saved snapshots and outputs the result to stdout or the reporter selected
+        with --test-reporter.
 
         :param arg_test_differ: Either the job_id or a list containing [job_id, max_diffs]
         :return: 1 if error, 0 if successful.

{webchanges-3.28.1 → webchanges-3.29.0}/webchanges/differs.py

@@ -151,12 +151,13 @@ class DifferBase(metaclass=TrackSubClasses):
         ) -> dict[str, Any]:
             """Obtain differ subdirectives that also contains defaults from the configuration.
 
-            :param differ_kind: The differ kind.
+            :param differ_spec: The differ as entered by the user; use "unified" if empty.
             :param directives: The differ directives as stated in the job.
+            :param config: The configuration.
             :returns: directives inclusive of configuration defaults.
             """
             if config is None:
-                logger.error('Cannot merge differ differdirectives with defaults as no config object was passed')
+                logger.info('No configuration object found to look for differ defaults')
                 return directives
             cfg = config.get('differ_defaults')
             if isinstance(cfg, dict):
@@ -261,9 +262,13 @@ class DifferBase(metaclass=TrackSubClasses):
         _unfiltered_diff: dict[Literal['text', 'markdown', 'html'], str] | None = None,
         tz: ZoneInfo | None = None,
     ) -> dict[Literal['text', 'markdown', 'html'], str]:
-        """Create a diff from the data. Since this function could be called by different reporters of multiple report
-        types ('text', 'markdown', 'html'), the differ outputs a dict with data for the report_kind it generated so
-        that it can be reused.
+        """Generate a formatted diff representation of data changes.
+
+        Creates a diff representation in one or more output formats (text, markdown, or HTML).
+        At minimum, this function must return output in the format specified by 'report_kind'.
+        As results are memoized for performance optimization, it can generate up to all three formats simultaneously.
+
+        :param state: The JobState.
 
         :param directives: The directives.
         :param report_kind: The report_kind for which a diff must be generated (at a minimum).
@@ -281,12 +286,14 @@ class DifferBase(metaclass=TrackSubClasses):
         timestamp: float,
         tz: ZoneInfo | None = None,
     ) -> str:
-        """Creates a datetime string in RFC 5322 (email) format with the time zone name (if available) in the
-        Comments and Folding White Space (CFWS) section.
+        """Format a timestamp as an RFC 5322 compliant datetime string.
+
+        Converts a numeric timestamp to a formatted datetime string following the RFC 5322 (email) standard. When a
+        timezone is provided, its full name, if known, is appended.
 
         :param timestamp: The timestamp.
         :param tz: The IANA timezone of the report.
-        :returns: A datetime string in RFC 5322 (email) format.
+        :returns: A datetime string in RFC 5322 (email) format or 'NEW' if timestamp is 0.
         """
         if timestamp:
             dt = datetime.fromtimestamp(timestamp).astimezone(tz=tz)
@@ -549,6 +556,7 @@ class CommandDiffer(DifferBase):
 
     __supported_directives__ = {
         'command': 'The command to execute',
+        'is_html': 'Whether the output of the command is HTML',
     }
 
     re_ptags = re.compile(r'^<p>|</p>$')
@@ -562,15 +570,30 @@ class CommandDiffer(DifferBase):
         _unfiltered_diff: dict[Literal['text', 'markdown', 'html'], str] | None = None,
         tz: ZoneInfo | None = None,
     ) -> dict[Literal['text', 'markdown', 'html'], str]:
+        if self.job.monospace:
+            head_html = '\n'.join(
+                [
+                    '<span style="font-family:monospace;white-space:pre-wrap;">',
+                    # f"Using command differ: {directives['command']}",
+                    f'<span style="color:darkred;">--- @ {self.make_timestamp(self.state.old_timestamp, tz)}</span>',
+                    f'<span style="color:darkgreen;">+++ @ {self.make_timestamp(self.state.new_timestamp, tz)}</span>',
+                ]
+            )
+        else:
+            head_html = '<br>\n'.join(
+                [
+                    '<span style="font-family:monospace;">',
+                    # f"Using command differ: {directives['command']}",
+                    f'<span style="color:darkred;">--- @ {self.make_timestamp(self.state.old_timestamp, tz)}</span>',
+                    f'<span style="color:darkgreen;">+++ @ {self.make_timestamp(self.state.new_timestamp, tz)}</span>',
+                    '</span>',
+                ]
+            )
+
         out_diff: dict[Literal['text', 'markdown', 'html'], str] = {}
         command = directives['command']
-        if (
-            report_kind == 'html'
-            and not command.startswith('wdiff')
-            and _unfiltered_diff is not None
-            and 'text' in _unfiltered_diff
-        ):
-            diff = _unfiltered_diff['text']
+        if report_kind == 'html' and _unfiltered_diff is not None and 'text' in _unfiltered_diff:
+            diff_text = ''.join(_unfiltered_diff['text'].splitlines(keepends=True)[2:])
         else:
             old_data = self.state.old_data
             new_data = self.state.new_data
@@ -606,12 +629,17 @@ class CommandDiffer(DifferBase):
                 ) from subprocess.CalledProcessError(proc.returncode, cmdline)
             if proc.returncode == 0:
                 self.state.verb = 'changed,no_report'
+                logger.info(
+                    f"Job {self.job.index_number}: Command in differ 'command' returned 0 (no report) "
+                    f'({self.job.get_location()})'
+                )
                 return {'text': '', 'markdown': '', 'html': ''}
-            head = '\n'.join(
+            head_text = '\n'.join(
                 [
-                    f'Using differ "{directives}"',
-                    f'--- @ {self.make_timestamp(self.state.old_timestamp, tz)}',
-                    f'+++ @ {self.make_timestamp(self.state.new_timestamp, tz)}',
+                    # f"Using command differ: {directives['command']}",
+                    f'\033[91m--- @ {self.make_timestamp(self.state.old_timestamp, tz)}\033[0m',
+                    f'\033[92m+++ @ {self.make_timestamp(self.state.new_timestamp, tz)}\033[0m',
+                    '',
                 ]
             )
             diff = proc.stdout
@@ -625,20 +653,33 @@ class CommandDiffer(DifferBase):
                     if any(x in line for x in {'{+', '+}', '[-', '-]'}):
                         keeplines.append(line)
                 diff = ''.join(keeplines)
-            diff = f'{head}\n{diff}'
-            out_diff.update(
-                {
-                    'text': diff,
-                    'markdown': diff,
-                }
-            )
+            if directives.get('is_html'):
+                diff_text = self.html2text(diff)
+                out_diff.update(
+                    {
+                        'text': head_text + diff_text,
+                        'markdown': head_text + diff_text,
+                        'html': head_html + diff,
+                    }
+                )
+            else:
+                diff_text = diff
+                out_diff.update(
+                    {
+                        'text': head_text + diff_text,
+                        'markdown': head_text + diff_text,
+                    }
+                )
 
-        if report_kind == 'html':
+        if report_kind == 'html' and 'html' not in out_diff:
             if command.startswith('wdiff'):
                 # colorize output of wdiff
-                out_diff['html'] = self.wdiff_to_html(diff)
+                out_diff['html'] = head_html + self.wdiff_to_html(diff_text)
             else:
-                out_diff['html'] = html.escape(diff)
+                out_diff['html'] = head_html + html.escape(diff_text)
+
+        if self.job.monospace and 'html' in out_diff:
+            out_diff['html'] += '</span>'
 
         return out_diff
 
@@ -991,6 +1032,7 @@ class ImageDiffer(DifferBase):
         def ai_google(
             old_image: Image.Image,
             new_image: Image.Image,
+            diff_image: Image.Image,
             directives: AiGoogleDirectives,
         ) -> str:
             """Summarize changes in image using Generative AI (ALPHA)."""
@@ -1073,10 +1115,6 @@ class ImageDiffer(DifferBase):
                     }
                 }
 
-            # Create a diff image
-            # diff_image = ImageChops.difference(old_image, new_image)
-            # diff_image.format = new_image.format
-
             # upload to Google
             additional_parts: list[dict[str, dict[str, str]]] = []
             executor = ThreadPoolExecutor()
@@ -1085,7 +1123,7 @@ class ImageDiffer(DifferBase):
                 (
                     ('old image', old_image),
                     ('new image', new_image),
-                    # ('differences image', diff_image),
+                    ('differences image', diff_image),
                 ),
             ):
                 if 'error' not in additional_part:
@@ -1107,22 +1145,33 @@ class ImageDiffer(DifferBase):
                 'focus on the most significant changes.'
             )
             model_prompt = (
+                'You are a skilled visual analyst tasked with analyzing two versions of an image and summarizing the '
+                'key differences between them. The audience for your summary is already familiar with the '
+                "image's content, so you should focus only on the most significant differences.\n\n"
                 '**Instructions:**\n\n'
-                f"1. Compare the new image {additional_parts[1]['file_data']['file_uri']} to the old image "
-                f"{additional_parts[0]['file_data']['file_uri']}, focusing only on major changes.\n"
-                '2. Summarize the meaning of the changes in a clear and concise manner. Be specific.\n'
-                '3. Use Markdown formatting to structure your summary effectively. Use headings, bullet points, and '
-                'other Markdown elements as needed to enhance readability.\n'
-                '4. Restrict your analysis and summary to these two specific images. Do not introduce external '
-                'information or assumptions. Do not introduce knowledge from images you may have already seen.\n'
+                '1. Carefully examine the yellow areas in the image '
+                f"{additional_parts[2]['file_data']['file_uri']}, identify the differences, and describe them.\n"
+                f"2. Refer to the old version of the image {additional_parts[0]['file_data']['file_uri']} and the new "
+                f" version {additional_parts[1]['file_data']['file_uri']}.\n"
+                '3. You are only interested in those differences, such as additions, removals, or alterations, that '
+                'modify the intended message or interpretation.\n'
+                '4. Summarize the identified differences, except those ignored, in a clear and concise manner, '
+                'explaining how the meaning has shifted or evolved in the new version compared to the old version only '
+                'when necessary. Be specific and provide examples to illustrate your points when needed.\n'
+                '5. If there are only additions to the image, then summarize the additions.\n'
+                '6. Use Markdown formatting to structure your summary effectively. Use headings, bullet points, '
+                'and other Markdown elements as needed to enhance readability.\n'
+                '7. Restrict your analysis and summary to the information provided within these images. Do '
+                'not introduce external information or assumptions.\n'
             )
-            summary = AIGoogleDiffer._send_to_model(
+            summary, _ = AIGoogleDiffer._send_to_model(
                 self.job,
                 system_instructions,
                 model_prompt,
                 additional_parts=additional_parts,  # type: ignore[arg-type]
                 directives=directives,
             )
+
             return summary
 
         data_type = directives.get('data_type', 'url')
@@ -1134,8 +1183,8 @@ class ImageDiffer(DifferBase):
         if data_type == 'url':
             old_image = load_image_from_web(self.state.old_data)
             new_image = load_image_from_web(self.state.new_data)
-            old_data = f' (<a href="{self.state.old_data}">Old image</a>)'
-            new_data = f' (<a href="{self.state.new_data}">New image</a>)'
+            old_data = f' (<a href="{self.state.old_data}" target="_blank">Old image</a>)'
+            new_data = f' (<a href="{self.state.new_data}" target="_blank">New image</a>)'
         elif data_type == 'ascii85':
             old_image = load_image_from_ascii85(self.state.old_data)
             new_image = load_image_from_ascii85(self.state.new_data)
@@ -1149,8 +1198,8 @@ class ImageDiffer(DifferBase):
         else:  # 'filename'
             old_image = load_image_from_file(self.state.old_data)
             new_image = load_image_from_file(self.state.new_data)
-            old_data = f' (<a href="file://{self.state.old_data}">Old image</a>)'
-            new_data = f' (<a href="file://{self.state.new_data}">New image</a>)'
+            old_data = f' (<a href="file://{self.state.old_data}" target="_blank">Old image</a>)'
+            new_data = f' (<a href="file://{self.state.new_data}" target="_blank">New image</a>)'
 
         # Check formats  TODO: is it needed? under which circumstances?
         # if new_image.format != old_image.format:
@@ -1202,7 +1251,7 @@ class ImageDiffer(DifferBase):
         # prepare AI summary
         summary = ''
         if 'ai_google' in directives:
-            summary = ai_google(old_image, new_image, directives.get('ai_google', {}))
+            summary = ai_google(old_image, new_image, diff_image, directives.get('ai_google', {}))
 
         # Prepare HTML output
         htm = [
@@ -1246,8 +1295,14 @@ class ImageDiffer(DifferBase):
         )
         footer = f'Summary generated by Google Generative AI (ai_google directive(s): {directives_text})'
         return {
-            'text': f'{summary}\n\n\nA visualization is available in HTML reports.\n------------\n{footer}',
-            'markdown': f'{summary}\n\n\nA visualization is available in HTML reports.\n* * *\n{footer}',
+            'text': (
+                f'{summary}\n\n\nA visualization of differences is available in {__package__} HTML reports.'
+                f'\n------------\n{footer}'
+            ),
+            'markdown': (
+                f'{summary}\n\n\nA visualization of differences is available in {__package__} HTML reports.'
+                f'\n* * *\n{footer}'
+            ),
             'html': '<br>\n'.join(
                 [
                     mark_to_html(summary, extras={'tables'}).replace('<h2>', '<h3>').replace('</h2>', '</h3>'),
@@ -1298,20 +1353,17 @@ class AIGoogleDiffer(DifferBase):
         model_prompt: str,
         additional_parts: list[dict[str, str | dict[str, str]]] | None = None,
         directives: AiGoogleDirectives | None = None,
-    ) -> str:
-        """Creates the summary request to the model"""
+    ) -> tuple[str, str]:
+        """Creates the summary request to the model; returns the summary and the version of the actual model used."""
         api_version = '1beta'
         if directives is None:
             directives = {}
-        if 'model' not in directives:
-            directives['model'] = 'gemini-2.0-flash'  # also for footer
-        model = directives.get('model')
+        model = directives.get('model', 'gemini-2.0-flash')
         timeout = directives.get('timeout', 300)
         max_output_tokens = directives.get('max_output_tokens')
         temperature = directives.get('temperature', 0.0)
-        top_p = directives.get('top_p')
+        top_p = directives.get('top_p', 1.0 if temperature == 0.0 else None)
         top_k = directives.get('top_k')
-
         GOOGLE_AI_API_KEY = os.environ.get('GOOGLE_AI_API_KEY', '').rstrip()
         if len(GOOGLE_AI_API_KEY) != 39:
             logger.error(
@@ -1321,7 +1373,8 @@ class AIGoogleDiffer(DifferBase):
             return (
                 f'## ERROR in summarizing changes using Google AI:\n'
                 f'Environment variable GOOGLE_AI_API_KEY not found or is of the incorrect length '
-                f'{len(GOOGLE_AI_API_KEY)}.\n'
+                f'{len(GOOGLE_AI_API_KEY)}.\n',
+                '',
             )
 
         data: dict[str, Any] = {
@@ -1339,6 +1392,7 @@ class AIGoogleDiffer(DifferBase):
         if directives.get('tools'):
             data['tools'] = directives['tools']
         logger.info(f'Job {job.index_number}: Making the content generation request to Google AI model {model}')
+        model_version = model  # default
         try:
             r = httpx.Client(http2=True).post(  # noqa: S113 Call to httpx without timeout
                 f'https://generativelanguage.googleapis.com/v{api_version}/models/{model}:generateContent?'
@@ -1358,6 +1412,8 @@ class AIGoogleDiffer(DifferBase):
                         f'AI summary unavailable: Model did not return any candidate output:\n'
                         f'{jsonlib.dumps(result, ensure_ascii=True, indent=2)}'
                     )
+                model_version = result['modelVersion']
+
             elif r.status_code == 400:
                 summary = (
                     f'AI summary unavailable: Received error from {r.url.host}: '
@@ -1375,7 +1431,7 @@ class AIGoogleDiffer(DifferBase):
                 f'AI summary unavailable: HTTP client error: {e} when requesting data from ' f'{e.request.url.host}'
             )
 
-        return summary
+        return summary, model_version
 
     def differ(
         self,
@@ -1392,8 +1448,8 @@ class AIGoogleDiffer(DifferBase):
             RuntimeWarning,
         )
 
-        def get_ai_summary(prompt: str, system_instructions: str) -> str:
-            """Generate AI summary from unified diff, or an error message"""
+        def get_ai_summary(prompt: str, system_instructions: str) -> tuple[str, str]:
+            """Generate AI summary from unified diff, or an error message, plus the model version."""
             GOOGLE_AI_API_KEY = os.environ.get('GOOGLE_AI_API_KEY', '').rstrip()
             if len(GOOGLE_AI_API_KEY) != 39:
                 logger.error(
@@ -1403,12 +1459,10 @@ class AIGoogleDiffer(DifferBase):
                 return (
                     f'## ERROR in summarizing changes using {self.__kind__}:\n'
                     f'Environment variable GOOGLE_AI_API_KEY not found or is of the incorrect length '
-                    f'{len(GOOGLE_AI_API_KEY)}.\n'
+                    f'{len(GOOGLE_AI_API_KEY)}.\n',
+                    '',
                 )
 
-            if 'model' not in directives:
-                directives['model'] = 'gemini-1.5-flash-latest'  # also for footer
-
             if '{unified_diff' in prompt:  # matches unified_diff or unified_diff_new
                 default_context_lines = 9999 if '{unified_diff}' in prompt else 0  # none if only unified_diff_new
                 context_lines = directives.get('prompt_ud_context_lines', default_context_lines)
@@ -1425,7 +1479,7 @@ class AIGoogleDiffer(DifferBase):
                 )
                 if not unified_diff:
                     # no changes
-                    return ''
+                    return '', ''
             else:
                 unified_diff = ''
 
@@ -1440,7 +1494,7 @@ class AIGoogleDiffer(DifferBase):
 
             # check if data is different (same data is sent during testing)
             if '{old_text}' in prompt and '{new_text}' in prompt and self.state.old_data == self.state.new_data:
-                return ''
+                return '', ''
 
             model_prompt = prompt.format(
                 unified_diff=unified_diff,
@@ -1449,14 +1503,14 @@ class AIGoogleDiffer(DifferBase):
                 new_text=self.state.new_data,
             )
 
-            summary = self._send_to_model(
+            summary, model_version = self._send_to_model(
                 self.job,
                 system_instructions,
                 model_prompt,
                 directives=directives,
             )
 
-            return summary
+            return summary, model_version
 
         if directives.get('additions_only') or self.job.additions_only:
             default_system_instructions = (
@@ -1472,7 +1526,7 @@ class AIGoogleDiffer(DifferBase):
                 'You are a skilled journalist tasked with analyzing two versions of a text and summarizing the key '
                 'differences in meaning between them. The audience for your summary is already familiar with the '
                 "text's content, so you can focus on the most significant changes.\n\n"
-                "**Instructions:**\n\n'"
+                '**Instructions:**\n\n'
                 '1. Carefully examine the old version of the text, provided within the `<old_version>` and '
                 '`</old_version>` tags.\n'
                 '2. Carefully examine the new version of the text, provided within the `<new_version>` and '
@@ -1483,25 +1537,38 @@ class AIGoogleDiffer(DifferBase):
                 '5. Summarize the identified differences, except those ignored, in a clear and concise manner, '
                 'explaining how the meaning has shifted or evolved in the new version compared to the old version only '
                 'when necessary. Be specific and provide examples to illustrate your points when needed.\n'
-                '6. If ther are only additions to the text, then summarize the additions.\n'
+                '6. If there are only additions to the text, then summarize the additions.\n'
                 '7. Use Markdown formatting to structure your summary effectively. Use headings, bullet points, '
                 'and other Markdown elements as needed to enhance readability.\n'
                 '8. Restrict your analysis and summary to the information provided within the `<old_version>` and '
-                '`<new_version> tags. Do not introduce external information or assumptions.\n'
+                '`<new_version>` tags. Do not introduce external information or assumptions.\n'
             )
             default_prompt = '<old_version>\n{old_text}\n</old_version>\n\n<new_version>\n{new_text}\n</new_version>'
         system_instructions = directives.get('system_instructions', default_system_instructions)
         prompt = directives.get('prompt', default_prompt).replace('\\n', '\n')
-        summary = get_ai_summary(prompt, system_instructions)
+        summary, model_version = get_ai_summary(prompt, system_instructions)
         if not summary:
             self.state.verb = 'changed,no_report'
             return {'text': '', 'markdown': '', 'html': ''}
         newline = '\n'  # For Python < 3.12 f-string {} compatibility
         back_n = '\\n'  # For Python < 3.12 f-string {} compatibility
-        directives_text = (
-            ', '.join(f'{key}={str(value).replace(newline, back_n)}' for key, value in directives.items()) or 'None'
+        directives.pop('model', None)
+        if directives:
+            directives_text = (
+                ' (differ directive(s): '
+                + (
+                    ', '.join(f'{key}={str(value).replace(newline, back_n)}' for key, value in directives.items())
+                    or 'None'
+                )
+                + ')'
+            )
+        else:
+            directives_text = ''
+        footer = (
+            f"Summary by Google Generative AI's model {model_version}{directives_text}"
+            if model_version and directives_text
+            else ''
         )
-        footer = f'Summary generated by Google Generative AI (differ directive(s): {directives_text})'
         temp_unfiltered_diff: dict[Literal['text', 'markdown', 'html'], str] = {}
         for rep_kind in ['text', 'html']:  # markdown is same as text
             unified_report = DifferBase.process(
@@ -1513,17 +1580,16 @@ class AIGoogleDiffer(DifferBase):
                 temp_unfiltered_diff,
             )
         return {
-            'text': f"{summary}\n\n{unified_report['text']}\n------------\n{footer}",
-            'markdown': f"{summary}\n\n{unified_report['markdown']}\n* * *\n{footer}",
+            'text': f"{summary}\n\n{unified_report['text']}" + (f'\n------------\n{footer}' if footer else ''),
+            'markdown': f"{summary}\n\n{unified_report['markdown']}" + (f'\n* * *\n{footer}' if footer else ''),
             'html': '\n'.join(
                 [
                     mark_to_html(summary, extras={'tables'}).replace('<h2>', '<h3>').replace('</h2>', '</h3>'),
                     '<br>',
                     '<br>',
                     unified_report['html'],
-                    '-----<br>',
-                    f'<i><small>{footer}</small></i>',
                 ]
+                + (['-----<br>', f'<i><small>{footer}</small></i>'] if footer else [])
             ),
         }
 
@@ -1575,10 +1641,13 @@ class WdiffDiffer(DifferBase):
         add_html = '<span style="background-color:#d1ffd1;color:#082b08;">'
         rem_html = '<span style="background-color:#fff0f0;color:#9c1c1c;text-decoration:line-through;">'
 
-        head_text = (
-            # f'Differ: wdiff\n'
-            f'\033[91m--- @ {self.make_timestamp(self.state.old_timestamp, tz)}\033[0m\n'
-            f'\033[92m+++ @ {self.make_timestamp(self.state.new_timestamp, tz)}\033[0m\n'
+        head_text = '\n'.join(
+            [
+                # f'Differ: wdiff',
+                f'\033[91m--- @ {self.make_timestamp(self.state.old_timestamp, tz)}\033[0m',
+                f'\033[92m+++ @ {self.make_timestamp(self.state.new_timestamp, tz)}\033[0m',
+                '',
+            ]
         )
         head_html = '<br>\n'.join(
             [

{webchanges-3.28.1 → webchanges-3.29.0}/webchanges/filters.py

@@ -194,7 +194,7 @@ class FilterBase(metaclass=TrackSubClasses):
                 if unknown_keys and '<any>' not in allowed_keys:
                     raise ValueError(
                         f'Job {job_index_number}: Filter {filter_kind} does not support subfilter or filter '
-                        f"directive(s) {', '.join(unknown_keys)} (supported: {', '.join(allowed_keys)})."
+                        f"directive(s) {', '.join(unknown_keys)}. Only {', '.join(allowed_keys)} are supported."
                     )
 
             yield filter_kind, subfilter
@@ -794,7 +794,10 @@ class FormatJsonFilter(FilterBase):
         self.job.set_to_monospace()
         sort_keys = subfilter.get('sort_keys', False)
         indentation = int(subfilter.get('indentation', 4))
-        parsed_json = jsonlib.loads(data)
+        try:
+            parsed_json = jsonlib.loads(data)
+        except jsonlib.JSONDecodeError as e:
+            return f"Filter '{self.__kind__}' returned JSONDecodeError: {e}\n\n{data!s}", mime_type
         if not mime_type.endswith('json'):
             mime_type = 'application/json'
         return jsonlib.dumps(parsed_json, ensure_ascii=False, sort_keys=sort_keys, indent=indentation), mime_type

{webchanges-3.28.1 → webchanges-3.29.0}/webchanges/handler.py

@@ -67,7 +67,7 @@ class JobState(ContextManager):
     exception: Exception | None = None
     generated_diff: dict[Literal['text', 'markdown', 'html'], str]
     history_dic_snapshots: dict[str | bytes, Snapshot]
-    new_data: str | bytes
+    new_data: str | bytes = ''
     new_error_data: ErrorData = {}
     new_etag: str
     new_mime_type: str = ''
@@ -234,18 +234,6 @@ class JobState(ContextManager):
                     f'{dict(data=data, etag=self.new_etag, mime_type=mime_type)}'
                 )
 
-                # Apply automatic filters first
-                filtered_data, mime_type = FilterBase.auto_process(self, data, mime_type)
-
-                # Apply any specified filters
-                for filter_kind, subfilter in FilterBase.normalize_filter_list(self.job.filters, self.job.index_number):
-                    filtered_data, mime_type = FilterBase.process(
-                        filter_kind, subfilter, self, filtered_data, mime_type
-                    )
-
-                self.new_data = filtered_data
-                self.new_mime_type = mime_type
-
             except Exception as e:
                 # Job has a chance to format and ignore its error
                 if self.debugger_attached():
@@ -258,31 +246,45 @@ class JobState(ContextManager):
                 if not (self.error_ignored or isinstance(e, NotModifiedError)):
                     self.tries += 1
                     self.new_error_data = {
-                        'type': type(self.exception).__name__,
-                        'message': str(self.exception),
+                        'type': e.__class__.__name__,
+                        'message': str(e),
                     }
                     logger.info(
                         f'Job {self.job.index_number}: Job ended with error; incrementing cumulative error runs to '
                         f'{self.tries}'
                     )
+
+            else:
+                # Apply automatic filters first
+                filtered_data, mime_type = FilterBase.auto_process(self, data, mime_type)
+
+                # Apply any specified filters
+                for filter_kind, subfilter in FilterBase.normalize_filter_list(self.job.filters, self.job.index_number):
+                    filtered_data, mime_type = FilterBase.process(
+                        filter_kind, subfilter, self, filtered_data, mime_type
+                    )
+
+                self.new_data = filtered_data
+                self.new_mime_type = mime_type
+
         except Exception as e:
-            # Job failed its chance to handle error
+            # Processing error or job failed its chance to handle error
             if self.debugger_attached():
                 logger.warning('Running in a debugger: raising the exception instead of processing it')
                 raise
+            self.new_timestamp = time.time()
             self.exception = e
-            self.traceback = self.job.format_error(e, traceback.format_exc())
+            self.traceback = ''.join(traceback.format_exception_only(e, show_group=True)).rstrip()
             self.error_ignored = False
-            if not isinstance(e, NotModifiedError):
-                self.tries += 1
-                self.new_error_data = {
-                    'type': type(self.exception).__name__,
-                    'message': str(self.exception),
-                }
-                logger.info(
-                    f'Job {self.job.index_number}: Job ended with error (internal handling failed); incrementing '
-                    f'cumulative error runs to {self.tries}'
-                )
+            self.tries += 1
+            self.new_error_data = {
+                'type': '.'.join(filter(None, [getattr(e, '__module__', None), e.__class__.__name__])),
+                'message': str(e),
+            }
+            logger.info(
+                f'Job {self.job.index_number}: Job ended with error (internal handling failed); incrementing '
+                f'cumulative error runs to {self.tries}'
+            )
 
         logger.debug(f'Job {self.job.index_number}: Processed as {self.added_data()}')
         logger.info(f'{self.job.get_indexed_location()} ended processing')
@@ -323,7 +325,7 @@ class JobState(ContextManager):
                 _generated_diff, _mime_type = FilterBase.process(  # type: ignore[assignment]
                     filter_kind, subfilter, self, _generated_diff, _mime_type
                 )
-        self.generated_diff[report_kind] = _generated_diff
+        self.generated_diff[report_kind] = str(_generated_diff)
 
         return self.generated_diff[report_kind]
 

{webchanges-3.28.1 → webchanges-3.29.0}/webchanges/jobs.py

@@ -786,7 +786,6 @@ class UrlJob(UrlJobBase):
                 http_error_msg = f'{response.status_code} Client Error: {reason} for url: {response.url}'
             else:
                 http_error_msg = f'{response.status_code} Server Error: {reason} for url: {response.url}'
-            logger.error(f'httpx received {http_error_msg}')
 
             if response.status_code != 404:
                 try:
@@ -858,8 +857,7 @@ class UrlJob(UrlJobBase):
                 urllib3.util.ssl_.DEFAULT_CIPHERS += 'HIGH:!DH:!aNULL'  # type: ignore[attr-defined]
             except AttributeError:
                 logger.error(
-                    'Unable to ignore_dh_key_too_small due to bug in '
-                    'requests.packages.urrlib3.util.ssl.DEFAULT_CIPHERS'
+                    'Unable to ignore_dh_key_too_small due to bug in requests.packages.urrlib3.util.ssl.DEFAULT_CIPHERS'
                 )
                 logger.error('See https://github.com/psf/requests/issues/6443')
 
@@ -1105,7 +1103,6 @@ class UrlJob(UrlJobBase):
         ):
             # Instead of a full traceback, just show the error
             exception_str = str(exception).strip()
-            print(f'{exception_str=} {exception.args=} {type(exception)=}')
             if self.proxy and (
                 (httpx and isinstance(exception, httpx.TransportError))
                 or any(
@@ -1373,7 +1370,7 @@ class BrowserJob(UrlJobBase):
                     ignore_default_args=ignore_default_args,
                     timeout=timeout,
                     headless=headless,
-                    proxy=proxy,
+                    proxy=proxy,  # type: ignore[arg-type]
                 )
                 browser_version = browser.version
                 user_agent = headers.pop(
@@ -1402,7 +1399,7 @@ class BrowserJob(UrlJobBase):
                     args=args,
                     ignore_default_args=ignore_default_args,
                     headless=headless,
-                    proxy=proxy,
+                    proxy=proxy,  # type: ignore[arg-type]
                     no_viewport=no_viewport,
                     ignore_https_errors=self.ignore_https_errors,
                     extra_http_headers=dict(headers),
@@ -1811,7 +1808,7 @@ class BrowserJob(UrlJobBase):
         :param tb: The traceback.format_exc() string.
         :returns: A string to display and/or use in reports.
         """
-        exception_str = f'Browser error in {str(exception).strip()}'
+        exception_str = str(exception).strip()
         print(f'{exception_str=}, {tb=}')
         if self.proxy and 'net::ERR' in exception_str:
             exception_str += f'\n\n(Job has proxy {self.proxy})'

{webchanges-3.28.1 → webchanges-3.29.0}/webchanges/reporters.py

@@ -117,7 +117,7 @@ if sys.platform == 'win32':
     try:
         from colorama import AnsiToWin32
     except ImportError as e:  # pragma: no cover
-        AnsiToWin32 = str(e)  # type: ignore[assignment]
+        AnsiToWin32 = str(e)  # type: ignore[assignment,misc]
 
 logger = logging.getLogger(__name__)
 
@@ -405,7 +405,7 @@ class HtmlReporter(ReporterBase):
                 [mark_to_html(line, job_state.job.markdown_padded_tables) for line in text.splitlines()]
             )
 
-        if job_state.verb == 'error':
+        if job_state.verb == 'error' or job_state.verb == 'repeated_error':
             htm = f'<pre style="white-space:pre-wrap;color:red;">{html.escape(job_state.traceback)}</pre>'
             if job_state.job.suppress_repeated_errors:
                 htm += (
@@ -518,7 +518,7 @@ class TextReporter(ReporterBase):
         :param differ: The type of differ to use.
         :returns: HTML for a single job.
         """
-        if job_state.verb == 'error':
+        if job_state.verb == 'error' or job_state.verb == 'repeated_error':
             if isinstance(self, StdoutReporter):
                 text = self._red(job_state.traceback)
             else:
@@ -780,7 +780,7 @@ class MarkdownReporter(ReporterBase):
         :param differ: The type of differ to use.
         :returns: HTML for a single job.
         """
-        if job_state.verb == 'error':
+        if job_state.verb == 'error' or job_state.verb == 'repeated_error':
             mark = job_state.traceback
             if job_state.job.suppress_repeated_errors:
                 mark += '_Reminder: No further alerts until the error is resolved or changes._'

{webchanges-3.28.1 → webchanges-3.29.0}/webchanges/storage.py

@@ -798,8 +798,8 @@ class YamlConfigStorage(BaseYamlFileStorage):
                     )
                 else:
                     config['job_defaults']['command'] = config['job_defaults'].pop(
-                        'shell'
-                    )  # type: ignore[typeddict-item]
+                        'shell'  # type: ignore[typeddict-item]
+                    )
 
             for key in {'all', 'url', 'browser', 'command'}:
                 if key not in config['job_defaults']:

{webchanges-3.28.1 → webchanges-3.29.0/webchanges.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: webchanges
-Version: 3.28.1
+Version: 3.29.0
 Summary: Web Changes Delivered. AI-Summarized. Totally Anonymous.
 Author-email: Mike Borsetti <mike+webchanges@borsetti.com>
 Maintainer-email: Mike Borsetti <mike+webchanges@borsetti.com>
@@ -163,6 +163,7 @@ Provides-Extra: safe-password
 Requires-Dist: keyring; extra == "safe-password"
 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]; extra == "all"
+Dynamic: license-file
 
 .. role:: underline
     :class: underline
@@ -195,7 +196,9 @@ For Generative AI summaries (BETA), you need a free `API Key from Google Cloud A
 
 Installation
 ============
-Install **webchanges** |pypi_version| |format| |status| |security| with:
+|pypi_version| |format| |status| |security|
+
+Install **webchanges**  with:
 
 .. code-block:: bash
 
@@ -203,7 +206,7 @@ Install **webchanges** |pypi_version| |format| |status| |security| with:
 
 Running in Docker
 -----------------
-**webchanges** can easily run in a container; you can find a `Docker <https://www.docker.com/>`__ implementation
+**webchanges** can easily run in a container and you will find a `Docker <https://www.docker.com/>`__ implementation
 `here <https://github.com/yubiuser/webchanges-docker>`__.
 
 
@@ -247,20 +250,19 @@ 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 Linux you can use cron, with the help of a tool like `crontab.guru <https://crontab.guru>`__ (help `here
+  <https://www.computerhope.com/unix/ucrontab.htm>`__);
 - 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).
+  .com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/ScheduledJobs.html>`__ (help `here
+  <https://launchd.info/>`__).
 
 
 Code
 ====
-|coveralls| |issues|
+|coveralls| |issues| |code_style|
 
-The code and issues tracker are hosted on `GitHub <https://github.com/mborsetti/webchanges>`__.
+The code, issues tracker, and discussions are hosted on `GitHub <https://github.com/mborsetti/webchanges>`__.
 
 
 Contributing
@@ -344,7 +346,7 @@ Example enhancements to HTML reporting:
 .. |format| image:: https://img.shields.io/pypi/format/webchanges.svg
     :target: https://pypi.org/project/webchanges/
     :alt: Kit format
-.. |downloads| image:: https://static.pepy.tech/badge/webchanges
+.. |downloads| image:: https://img.shields.io/pypi/dm/webchanges.svg
     :target: https://www.pepy.tech/project/webchanges
     :alt: PyPI downloads
 .. |license| image:: https://img.shields.io/pypi/l/webchanges.svg
@@ -356,15 +358,24 @@ Example enhancements to HTML reporting:
 .. |readthedocs| image:: https://img.shields.io/readthedocs/webchanges/stable.svg?label=
     :target: https://webchanges.readthedocs.io/
     :alt: Documentation status
-.. |CI| image:: https://github.com/mborsetti/webchanges/actions/workflows/ci-cd.yaml/badge.svg?event=push
+.. |old_CI| image:: https://github.com/mborsetti/webchanges/actions/workflows/ci-cd.yaml/badge.svg?event=push
+    :target: https://github.com/mborsetti/webchanges/actions
+    :alt: CI testing status
+.. |CI| image:: https://img.shields.io/github/check-runs/mborsetti/webchanges/main
     :target: https://github.com/mborsetti/webchanges/actions
     :alt: CI testing status
-.. |coveralls| image:: https://coveralls.io/repos/github/mborsetti/webchanges/badge.svg?branch=main
+.. |old_coveralls| image:: https://coveralls.io/repos/github/mborsetti/webchanges/badge.svg?branch=main
+    :target: https://coveralls.io/github/mborsetti/webchanges?branch=main
+    :alt: Code coverage by Coveralls
+.. |coveralls| image:: https://img.shields.io/coverallsCoverage/github/mborsetti/webchanges.svg
     :target: https://coveralls.io/github/mborsetti/webchanges?branch=main
     :alt: Code coverage by Coveralls
+.. |code_style| image:: https://img.shields.io/badge/code%20style-black-000000.svg
+    :target: https://github.com/psf/black
+    :alt: Code style black
 .. |status| image:: https://img.shields.io/pypi/status/webchanges.svg
     :target: https://pypi.org/project/webchanges/
     :alt: Package stability
-.. |security| image:: https://img.shields.io/badge/security-bandit-yellow.svg
+.. |security| image:: https://img.shields.io/badge/security-bandit-green.svg
     :target: https://github.com/PyCQA/bandit
     :alt: Security Status

{webchanges-3.28.1 → webchanges-3.29.0}/webchanges.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ README.rst
 pyproject.toml
 requirements.txt
 webchanges/__init__.py
+webchanges/__main__.py
 webchanges/cli.py
 webchanges/command.py
 webchanges/config.py