webchanges 3.36.1__tar.gz → 3.38.0__tar.gz

{webchanges-3.36.1/webchanges.egg-info → webchanges-3.38.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: webchanges
-Version: 3.36.1
+Version: 3.38.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>
@@ -21,10 +21,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 :: Free Threading
 Classifier: Programming Language :: Python :: Free Threading :: 4 - Resilient
 Classifier: Programming Language :: Python :: Implementation :: CPython
@@ -34,10 +34,9 @@ Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
 Classifier: Topic :: System :: Monitoring
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
-Requires-Python: >=3.11
+Requires-Python: >=3.12
 Description-Content-Type: text/x-rst
 License-File: LICENSE.md
-Requires-Dist: colorama; sys_platform == "win32"
 Requires-Dist: cssselect
 Requires-Dist: h2
 Requires-Dist: html2text
@@ -64,7 +63,7 @@ Requires-Dist: html5lib; extra == "html5lib"
 Provides-Extra: ical2text
 Requires-Dist: vobject; extra == "ical2text"
 Provides-Extra: jq
-Requires-Dist: jq; os_name != "nt" and extra == "jq"
+Requires-Dist: jq; extra == "jq"
 Provides-Extra: ocr
 Requires-Dist: pytesseract; extra == "ocr"
 Requires-Dist: Pillow; extra == "ocr"
@@ -75,10 +74,14 @@ Requires-Dist: pypdf; extra == "pypdf"
 Provides-Extra: pypdf-crypto
 Requires-Dist: pypdf; extra == "pypdf-crypto"
 Requires-Dist: cryptography; extra == "pypdf-crypto"
+Provides-Extra: xmltodict
+Requires-Dist: xmltodict; extra == "xmltodict"
 Provides-Extra: deepdiff
-Requires-Dist: deepdiff; extra == "deepdiff"
+Requires-Dist: deepdiff>=8.0; python_version < "3.15" and extra == "deepdiff"
+Requires-Dist: deepdiff<9,>=8.0; python_version >= "3.15" and extra == "deepdiff"
 Provides-Extra: deepdiff-xml
-Requires-Dist: deepdiff; extra == "deepdiff-xml"
+Requires-Dist: deepdiff>=8.0; python_version < "3.15" and extra == "deepdiff-xml"
+Requires-Dist: deepdiff<9,>=8.0; python_version >= "3.15" and extra == "deepdiff-xml"
 Requires-Dist: xmltodict; extra == "deepdiff-xml"
 Provides-Extra: imagediff
 Requires-Dist: Pillow; extra == "imagediff"
@@ -99,7 +102,7 @@ Requires-Dist: requests; extra == "requests"
 Provides-Extra: safe-password
 Requires-Dist: keyring; extra == "safe-password"
 Provides-Extra: all
-Requires-Dist: webchanges[beautify,bs4,curl_cffi,deepdiff_xml,html5lib,ical2text,imagediff,jq,matrix,ocr,pdf2text,pushbullet,pushover,pypdf_crypto,redis,requests,safe_password,use_browser,xmpp]; extra == "all"
+Requires-Dist: webchanges[beautify,bs4,curl_cffi,deepdiff_xml,html5lib,ical2text,imagediff,jq,matrix,ocr,pdf2text,pushbullet,pushover,pypdf_crypto,redis,requests,safe_password,use_browser,xmltodict,xmpp]; extra == "all"
 Dynamic: license-file
 
 .. role:: underline
@@ -118,26 +121,35 @@ notifications and AI-powered summaries to your favorite `platform
 <https://webchanges.readthedocs.io/en/stable/introduction.html#reporters>`__.
 
 
-Requirements
-============
-**webchanges** requires |support|.
+Highlights
+==========
+- **AI-powered change summaries** via Gemini (`ai_google differ
+  <https://webchanges.readthedocs.io/en/stable/differs.html#ai-google-diff>`__, BETA).
+- **Structural diffs for JSON and XML** via the `deepdiff differ
+  <https://webchanges.readthedocs.io/en/stable/differs.html#deepdiff-diff>`__.
+- **Visual diffs for images** via the `image differ
+  <https://webchanges.readthedocs.io/en/stable/differs.html#image-diff>`__ (BETA).
+- **Bypass TLS/JA3 fingerprinting** with the optional `curl_cffi
+  <https://webchanges.readthedocs.io/en/stable/jobs.html#http-client>`__ HTTP client.
+- **JSON-Schema-validated** ``jobs.yaml`` and ``config.yaml`` for editor autocompletion and inline validation.
 
-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.
 
-While **webchanges** supports free-threated Python, certain optional dependencies may not.
+Requirements
+============
+**webchanges** requires |support|. For the best experience, use the current version of `Python
+<https://www.python.org/downloads/>`__; older Python versions are supported for 3 years after they're replaced. Free-threaded Python is supported, though some
+optional dependencies may not be.
 
 For Generative AI summaries (BETA), you need a free `API Key from Google Cloud AI Studio
 <https://aistudio.google.com/app/apikey>`__ (see `here
-<https://webchanges.readthedocs.io/en/stable/differs.html#ai-google>`__).
+<https://webchanges.readthedocs.io/en/stable/differs.html#ai-google-diff>`__).
 
 
 Installation
 ============
 |pypi_version| |format| |status|
 
-Install **webchanges**  with ``uv`` (recommended):
+Install **webchanges**  with `uv <https://docs.astral.sh/uv/>`__ (recommended):
 
 .. code-block:: bash
 
@@ -149,22 +161,22 @@ or with ``pip``:
 
    pip install webchanges
 
-Running in Docker
------------------
-**webchanges** can easily run in a `Docker <https://www.docker.com/>`__ container! You will find a minimal
-implementation (no browser) `here <https://github.com/yubiuser/webchanges-docker>`__, and one with a browser
-`here <https://github.com/jhedlund/webchanges-docker>`__.
+On Windows with Python 3.15, first run ``set PYYAML_FORCE_LIBYAML=0`` (in PowerShell:
+``$env:PYYAML_FORCE_LIBYAML = "0"``), as explained `here
+<https://webchanges.readthedocs.io/en/stable/introduction.html#install-windows>`__.
 
-As a GitHub Action
-------------------
-**webchanges** can easily run as a `GitHub Action <https://www.docker.com/>`__! You will find an implementation
-`here <https://github.com/swimmwatch/webchanges-action>`__.
+Other ways to run
+-----------------
+- In a `Docker <https://www.docker.com/>`__ container: a minimal implementation (no browser) is `here
+  <https://github.com/yubiuser/webchanges-docker>`__, and one with a browser is `here
+  <https://github.com/jhedlund/webchanges-docker>`__.
+- As a `GitHub Action <https://docs.github.com/en/actions>`__: an implementation is `here
+  <https://github.com/swimmwatch/webchanges-action>`__.
 
 
 Documentation |readthedocs|
 ===========================
-The documentation is hosted on `Read the Docs <https://webchanges.readthedocs.io/>`__.  A (very good) AI-generated
-high-level architectural overview is available on `DeepWiki <https://deepwiki.com/mborsetti/webchanges>`__.
+The documentation is hosted on `Read the Docs <https://webchanges.readthedocs.io/>`__.
 
 
 Quick Start
@@ -238,13 +250,11 @@ licensed under a `BSD 3-Clause License
 <https://raw.githubusercontent.com/thp/urlwatch/346b25914b0418342ffe2fb0529bed702fddc01f/COPYING>`__).
 
 
-Compatibility with **urlwatch**
-===============================
-
-This project is based on code from `urlwatch 2.21
-<https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__ dated 30 July 2020.
-For upgrading from **urlwatch** to **webchanges** (using the same job and
-configuration files), see `here <https://webchanges.readthedocs.io/en/stable/upgrading.html>`__.
+Relationship with **urlwatch**
+==============================
+This project is a fork of `urlwatch 2.21
+<https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__ and has since added many features;
+see the `comparison <https://webchanges.readthedocs.io/en/stable/upgrading.html>`__.
 
 
 .. |support| image:: https://img.shields.io/pypi/pyversions/webchanges.svg

{webchanges-3.36.1 → webchanges-3.38.0}/README.rst

@@ -14,26 +14,35 @@ notifications and AI-powered summaries to your favorite `platform
 <https://webchanges.readthedocs.io/en/stable/introduction.html#reporters>`__.
 
 
-Requirements
-============
-**webchanges** requires |support|.
+Highlights
+==========
+- **AI-powered change summaries** via Gemini (`ai_google differ
+  <https://webchanges.readthedocs.io/en/stable/differs.html#ai-google-diff>`__, BETA).
+- **Structural diffs for JSON and XML** via the `deepdiff differ
+  <https://webchanges.readthedocs.io/en/stable/differs.html#deepdiff-diff>`__.
+- **Visual diffs for images** via the `image differ
+  <https://webchanges.readthedocs.io/en/stable/differs.html#image-diff>`__ (BETA).
+- **Bypass TLS/JA3 fingerprinting** with the optional `curl_cffi
+  <https://webchanges.readthedocs.io/en/stable/jobs.html#http-client>`__ HTTP client.
+- **JSON-Schema-validated** ``jobs.yaml`` and ``config.yaml`` for editor autocompletion and inline validation.
 
-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.
 
-While **webchanges** supports free-threated Python, certain optional dependencies may not.
+Requirements
+============
+**webchanges** requires |support|. For the best experience, use the current version of `Python
+<https://www.python.org/downloads/>`__; older Python versions are supported for 3 years after they're replaced. Free-threaded Python is supported, though some
+optional dependencies may not be.
 
 For Generative AI summaries (BETA), you need a free `API Key from Google Cloud AI Studio
 <https://aistudio.google.com/app/apikey>`__ (see `here
-<https://webchanges.readthedocs.io/en/stable/differs.html#ai-google>`__).
+<https://webchanges.readthedocs.io/en/stable/differs.html#ai-google-diff>`__).
 
 
 Installation
 ============
 |pypi_version| |format| |status|
 
-Install **webchanges**  with ``uv`` (recommended):
+Install **webchanges**  with `uv <https://docs.astral.sh/uv/>`__ (recommended):
 
 .. code-block:: bash
 
@@ -45,22 +54,22 @@ or with ``pip``:
 
    pip install webchanges
 
-Running in Docker
------------------
-**webchanges** can easily run in a `Docker <https://www.docker.com/>`__ container! You will find a minimal
-implementation (no browser) `here <https://github.com/yubiuser/webchanges-docker>`__, and one with a browser
-`here <https://github.com/jhedlund/webchanges-docker>`__.
+On Windows with Python 3.15, first run ``set PYYAML_FORCE_LIBYAML=0`` (in PowerShell:
+``$env:PYYAML_FORCE_LIBYAML = "0"``), as explained `here
+<https://webchanges.readthedocs.io/en/stable/introduction.html#install-windows>`__.
 
-As a GitHub Action
-------------------
-**webchanges** can easily run as a `GitHub Action <https://www.docker.com/>`__! You will find an implementation
-`here <https://github.com/swimmwatch/webchanges-action>`__.
+Other ways to run
+-----------------
+- In a `Docker <https://www.docker.com/>`__ container: a minimal implementation (no browser) is `here
+  <https://github.com/yubiuser/webchanges-docker>`__, and one with a browser is `here
+  <https://github.com/jhedlund/webchanges-docker>`__.
+- As a `GitHub Action <https://docs.github.com/en/actions>`__: an implementation is `here
+  <https://github.com/swimmwatch/webchanges-action>`__.
 
 
 Documentation |readthedocs|
 ===========================
-The documentation is hosted on `Read the Docs <https://webchanges.readthedocs.io/>`__.  A (very good) AI-generated
-high-level architectural overview is available on `DeepWiki <https://deepwiki.com/mborsetti/webchanges>`__.
+The documentation is hosted on `Read the Docs <https://webchanges.readthedocs.io/>`__.
 
 
 Quick Start
@@ -134,13 +143,11 @@ licensed under a `BSD 3-Clause License
 <https://raw.githubusercontent.com/thp/urlwatch/346b25914b0418342ffe2fb0529bed702fddc01f/COPYING>`__).
 
 
-Compatibility with **urlwatch**
-===============================
-
-This project is based on code from `urlwatch 2.21
-<https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__ dated 30 July 2020.
-For upgrading from **urlwatch** to **webchanges** (using the same job and
-configuration files), see `here <https://webchanges.readthedocs.io/en/stable/upgrading.html>`__.
+Relationship with **urlwatch**
+==============================
+This project is a fork of `urlwatch 2.21
+<https://github.com/thp/urlwatch/tree/346b25914b0418342ffe2fb0529bed702fddc01f>`__ and has since added many features;
+see the `comparison <https://webchanges.readthedocs.io/en/stable/upgrading.html>`__.
 
 
 .. |support| image:: https://img.shields.io/pypi/pyversions/webchanges.svg

{webchanges-3.36.1 → webchanges-3.38.0}/pyproject.toml

@@ -16,7 +16,7 @@ dynamic = ['version', 'dependencies']
 name = 'webchanges'
 description = 'Web Changes Delivered. AI-Summarized. Totally Anonymous.'
 readme = { file = 'README.rst', content-type = 'text/x-rst' }
-requires-python = '>=3.11'
+requires-python = '>=3.12'
 license = "MIT AND BSD-3-Clause"
 license-files = ['LICENSE.md']
 authors = [{ name = 'Mike Borsetti', email = 'mike+webchanges@borsetti.com' }]
@@ -35,10 +35,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 :: Free Threading',
     'Programming Language :: Python :: Free Threading :: 4 - Resilient',
     'Programming Language :: Python :: Implementation :: CPython',
@@ -70,14 +70,22 @@ beautify = ['beautifulsoup4', 'jsbeautifier', 'cssbeautifier']
 bs4 = ['beautifulsoup4']
 html5lib = ['html5lib']
 ical2text = ['vobject']
-jq = ['jq; os_name != "nt"']
+jq = ['jq']
 ocr = ['pytesseract', 'Pillow']
 pdf2text = ['pdftotext']
 pypdf = ['pypdf']
 pypdf_crypto = ['pypdf', 'cryptography']
+xmltodict = ['xmltodict']  # xmltojson and xmltoyaml filters
 # differs
-deepdiff = ['deepdiff']
-deepdiff_xml = ['deepdiff', 'xmltodict']
+# deepdiff >= 8.0 is required for threshold_to_diff_deeper
+# deepdiff < 9 on Python >= 3.15: deepdiff 9 requires cachebox < 6, and cachebox 5.x has no 3.15 wheels and cannot be
+# built for 3.15 (it uses PyO3 0.27, which supports Python only up to 3.14). Keep in sync with tests/requirements_*.txt
+deepdiff = ['deepdiff >= 8.0; python_version < "3.15"', 'deepdiff >= 8.0, < 9; python_version >= "3.15"']
+deepdiff_xml = [
+    'deepdiff >= 8.0; python_version < "3.15"',
+    'deepdiff >= 8.0, < 9; python_version >= "3.15"',
+    'xmltodict',
+]
 imagediff = ['Pillow']
 # reporters
 matrix = ['matrix_client']
@@ -91,7 +99,7 @@ requests = ['requests']
 safe_password = ['keyring']
 # all
 all = [
-    'webchanges[use_browser,beautify,bs4,html5lib,ical2text,jq,ocr,pdf2text,pypdf_crypto,deepdiff_xml,imagediff,matrix,pushbullet,pushover,xmpp,curl_cffi,redis,requests,safe_password]',
+    'webchanges[use_browser,beautify,bs4,html5lib,ical2text,jq,ocr,pdf2text,pypdf_crypto,xmltodict,deepdiff_xml,imagediff,matrix,pushbullet,pushover,xmpp,curl_cffi,redis,requests,safe_password]',
 ]
 
 
@@ -210,6 +218,14 @@ report_level = 'WARNING'
 # log_cli = true
 minversion = '9.0.2'
 testpaths = ['tests']
+filterwarnings = [
+    # Fail tests that leak sqlite3 connections. Scoped by message so third-party ResourceWarnings (e.g.
+    # asyncio/playwright transports) don't destabilize the suite. The second entry is required because the warning
+    # is emitted during garbage collection: the error raised there is unraisable, and only surfaces as a test
+    # failure through pytest's unraisable-exception plugin (as a PytestUnraisableExceptionWarning).
+    'error:unclosed database:ResourceWarning',
+    'error:(?s).*unclosed database:pytest.PytestUnraisableExceptionWarning',
+]
 
 # pytest-playwright
 # addopts = ['--browser', 'chromium', '--browser-channel', 'chrome']

{webchanges-3.36.1 → webchanges-3.38.0}/requirements.txt

@@ -1,4 +1,3 @@
-colorama; sys_platform == 'win32'
 cssselect
 h2
 html2text

{webchanges-3.36.1 → webchanges-3.38.0}/webchanges/__init__.py

@@ -12,7 +12,7 @@ supported services. Can check the output of local commands as well.
 
 from __future__ import annotations
 
-__min_python_version__ = (3, 11)  # minimum version of Python required to run; 3.11 supported until fall 2026
+__min_python_version__ = (3, 12)  # minimum version of Python required to run; 3.12 supported until 7 October 2027
 
 
 __project_name__ = str(__package__)
@@ -22,7 +22,7 @@ __project_name__ = str(__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.36.1'
+__version__ = '3.38.0'
 __description__ = (
     'Check web (or command output) for changes since last run and notify.\n\nAnonymously alerts you of web changes.'
 )

webchanges-3.38.0/webchanges/__main__.py

@@ -0,0 +1,11 @@
+if __name__ == '__main__':
+    import sys
+    from pathlib import Path
+
+    cwd = str(Path.cwd())
+    if cwd not in sys.path:
+        sys.path.insert(0, cwd)
+
+    from webchanges.cli import main
+
+    main()