webchanges 3.38.0__tar.gz → 3.40.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: webchanges
-Version: 3.38.0
+Version: 3.40.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>
@@ -40,7 +40,7 @@ License-File: LICENSE.md
 Requires-Dist: cssselect
 Requires-Dist: h2
 Requires-Dist: html2text
-Requires-Dist: httpx
+Requires-Dist: httpx2
 Requires-Dist: lxml
 Requires-Dist: markdown2
 Requires-Dist: msgpack
@@ -77,11 +77,11 @@ Requires-Dist: cryptography; extra == "pypdf-crypto"
 Provides-Extra: xmltodict
 Requires-Dist: xmltodict; extra == "xmltodict"
 Provides-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"
+Requires-Dist: deepdiff; python_version < "3.15" and extra == "deepdiff"
+Requires-Dist: deepdiff<9.1; python_version >= "3.15" and extra == "deepdiff"
 Provides-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: deepdiff; python_version < "3.15" and extra == "deepdiff-xml"
+Requires-Dist: deepdiff<9.1; python_version >= "3.15" and extra == "deepdiff-xml"
 Requires-Dist: xmltodict; extra == "deepdiff-xml"
 Provides-Extra: imagediff
 Requires-Dist: Pillow; extra == "imagediff"
@@ -92,7 +92,7 @@ Requires-Dist: pushbullet.py; extra == "pushbullet"
 Provides-Extra: pushover
 Requires-Dist: chump; extra == "pushover"
 Provides-Extra: xmpp
-Requires-Dist: aioxmpp; extra == "xmpp"
+Requires-Dist: slixmpp; extra == "xmpp"
 Provides-Extra: curl-cffi
 Requires-Dist: curl_cffi; extra == "curl-cffi"
 Provides-Extra: redis
@@ -123,22 +123,25 @@ notifications and AI-powered summaries to your favorite `platform
 
 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.
+- **Watch anything**: web pages (in a `real browser
+  <https://webchanges.readthedocs.io/en/stable/jobs.html#use-browser>`__ if needed), APIs, local files and command
+  output.
+- **Track only what matters** with over 30 `filters <https://webchanges.readthedocs.io/en/stable/filters.html>`__.
+- **Read changes at a glance** in formatted HTML, side by side, word by word, as `AI summaries
+  <https://webchanges.readthedocs.io/en/stable/differs.html#ai-google-diff>`__ and more.
+- **Get notified anywhere**: email, Telegram, Discord, ntfy, webhooks and `more
+  <https://webchanges.readthedocs.io/en/stable/reporters.html>`__.
+- **Few false alarms**: transient errors can be held back and repeated ones reported `once
+  <https://webchanges.readthedocs.io/en/stable/jobs.html#suppress-repeated-errors>`__.
+- **Runs on your machine**, total privacy, no account needed, and extends with Python `hooks
+  <https://webchanges.readthedocs.io/en/stable/hooks.html>`__.
 
 
 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.
+<https://www.python.org/downloads/>`__; older Python versions are supported for 3 years after they're replaced.
+Free-threaded Python is supported.
 
 For Generative AI summaries (BETA), you need a free `API Key from Google Cloud AI Studio
 <https://aistudio.google.com/app/apikey>`__ (see `here
@@ -167,9 +170,10 @@ On Windows with Python 3.15, first run ``set PYYAML_FORCE_LIBYAML=0`` (in PowerS
 
 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>`__.
+- In a `Docker <https://www.docker.com/>`__ container: download a third-party container, `yubiuser/webchanges-docker
+  <https://github.com/yubiuser/webchanges-docker>`__ (no browser) or `jhedlund/webchanges-docker
+  <https://github.com/jhedlund/webchanges-docker>`__ (with a browser), or adapt the tested `sample Dockerfile
+  <https://webchanges.readthedocs.io/en/stable/advanced.html#docker-sample>`__ (no browser).
 - As a `GitHub Action <https://docs.github.com/en/actions>`__: an implementation is `here
   <https://github.com/swimmwatch/webchanges-action>`__.
 
@@ -224,7 +228,7 @@ Schedule
 
 Code
 ====
-|coveralls| |issues| |code_style| |OpenSSF_Scorecard|
+|coveralls| |issues| |code_style|
 
 The code, issues tracker, and discussions are hosted on `GitHub <https://github.com/mborsetti/webchanges>`__.
 
@@ -243,10 +247,11 @@ License
 =======
 |license|
 
-See the `complete licenses <https://raw.githubusercontent.com/mborsetti/webchanges/refs/heads/main/LICENSE.md>`__ (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
+See the `complete licenses
+<https://raw.githubusercontent.com/mborsetti/webchanges/refs/heads/main/LICENSE.md>`__ (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>`__).
 
 
@@ -302,6 +307,3 @@ see the `comparison <https://webchanges.readthedocs.io/en/stable/upgrading.html>
 .. .. |snyk| image:: https://snyk.io/advisor/python/webchanges/badge.svg
 ..     :target: https://security.snyk.io/package/pip/webchanges
 ..     :alt: Snyk Package Health Score
-.. |OpenSSF_Scorecard| image:: https://api.scorecard.dev/projects/github.com/mborsetti/webchanges/badge
-    :target: https://scorecard.dev/viewer/?uri=github.com/mborsetti/webchanges
-    :alt: OpenSSF Scoreard

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

@@ -16,22 +16,25 @@ notifications and AI-powered summaries to your favorite `platform
 
 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.
+- **Watch anything**: web pages (in a `real browser
+  <https://webchanges.readthedocs.io/en/stable/jobs.html#use-browser>`__ if needed), APIs, local files and command
+  output.
+- **Track only what matters** with over 30 `filters <https://webchanges.readthedocs.io/en/stable/filters.html>`__.
+- **Read changes at a glance** in formatted HTML, side by side, word by word, as `AI summaries
+  <https://webchanges.readthedocs.io/en/stable/differs.html#ai-google-diff>`__ and more.
+- **Get notified anywhere**: email, Telegram, Discord, ntfy, webhooks and `more
+  <https://webchanges.readthedocs.io/en/stable/reporters.html>`__.
+- **Few false alarms**: transient errors can be held back and repeated ones reported `once
+  <https://webchanges.readthedocs.io/en/stable/jobs.html#suppress-repeated-errors>`__.
+- **Runs on your machine**, total privacy, no account needed, and extends with Python `hooks
+  <https://webchanges.readthedocs.io/en/stable/hooks.html>`__.
 
 
 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.
+<https://www.python.org/downloads/>`__; older Python versions are supported for 3 years after they're replaced.
+Free-threaded Python is supported.
 
 For Generative AI summaries (BETA), you need a free `API Key from Google Cloud AI Studio
 <https://aistudio.google.com/app/apikey>`__ (see `here
@@ -60,9 +63,10 @@ On Windows with Python 3.15, first run ``set PYYAML_FORCE_LIBYAML=0`` (in PowerS
 
 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>`__.
+- In a `Docker <https://www.docker.com/>`__ container: download a third-party container, `yubiuser/webchanges-docker
+  <https://github.com/yubiuser/webchanges-docker>`__ (no browser) or `jhedlund/webchanges-docker
+  <https://github.com/jhedlund/webchanges-docker>`__ (with a browser), or adapt the tested `sample Dockerfile
+  <https://webchanges.readthedocs.io/en/stable/advanced.html#docker-sample>`__ (no browser).
 - As a `GitHub Action <https://docs.github.com/en/actions>`__: an implementation is `here
   <https://github.com/swimmwatch/webchanges-action>`__.
 
@@ -117,7 +121,7 @@ Schedule
 
 Code
 ====
-|coveralls| |issues| |code_style| |OpenSSF_Scorecard|
+|coveralls| |issues| |code_style|
 
 The code, issues tracker, and discussions are hosted on `GitHub <https://github.com/mborsetti/webchanges>`__.
 
@@ -136,10 +140,11 @@ License
 =======
 |license|
 
-See the `complete licenses <https://raw.githubusercontent.com/mborsetti/webchanges/refs/heads/main/LICENSE.md>`__ (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
+See the `complete licenses
+<https://raw.githubusercontent.com/mborsetti/webchanges/refs/heads/main/LICENSE.md>`__ (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>`__).
 
 
@@ -194,7 +199,4 @@ see the `comparison <https://webchanges.readthedocs.io/en/stable/upgrading.html>
 ..     :alt: Security Status
 .. .. |snyk| image:: https://snyk.io/advisor/python/webchanges/badge.svg
 ..     :target: https://security.snyk.io/package/pip/webchanges
-..     :alt: Snyk Package Health Score
-.. |OpenSSF_Scorecard| image:: https://api.scorecard.dev/projects/github.com/mborsetti/webchanges/badge
-    :target: https://scorecard.dev/viewer/?uri=github.com/mborsetti/webchanges
-    :alt: OpenSSF Scoreard
+..     :alt: Snyk Package Health Score

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

@@ -77,13 +77,12 @@ pypdf = ['pypdf']
 pypdf_crypto = ['pypdf', 'cryptography']
 xmltodict = ['xmltodict']  # xmltojson and xmltoyaml filters
 # differs
-# 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
+# deepdiff < 9.1 on Python >= 3.15: deepdiff 9.1 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 = ['deepdiff; python_version < "3.15"', 'deepdiff < 9.1; python_version >= "3.15"']
 deepdiff_xml = [
-    'deepdiff >= 8.0; python_version < "3.15"',
-    'deepdiff >= 8.0, < 9; python_version >= "3.15"',
+    'deepdiff; python_version < "3.15"',
+    'deepdiff < 9.1; python_version >= "3.15"',
     'xmltodict',
 ]
 imagediff = ['Pillow']
@@ -91,7 +90,7 @@ imagediff = ['Pillow']
 matrix = ['matrix_client']
 pushbullet = ['pushbullet.py']
 pushover = ['chump']
-xmpp = ['aioxmpp']
+xmpp = ['slixmpp']
 # other
 curl_cffi = ['curl_cffi']
 redis = ['redis']
@@ -126,7 +125,7 @@ dependencies = { file = 'requirements.txt' }
 
 [tool.setuptools.package-data]
 'webchanges' = ['py.typed']
-'webchanges._resources' = ['*.schema.json', '*.schema.sha256']
+'webchanges._resources' = ['*.schema.json', '.*.schema.sha256']  # globs skip dotfiles unless the dot is explicit
 
 # -------------------------- manpages --------------------------
 # https://github.com/praiskup/argparse-manpage/blob/main/README.md
@@ -154,6 +153,7 @@ omit = [
     'pip/*',
     'tests/*',
     'webchanges/_vendored/*',
+    'webchanges/storage/_redis.py',
     'webchanges.egg-info/*',
 ]
 relative_files = true
@@ -258,26 +258,43 @@ line-length = 120
 # By default, Ruff enables Flake8's F rules, along with a subset of the E rules
 # Enable rules not enabled by default, and ignore specific rules.
 select = [
+    # 'AIR',  # Airflow
+    # 'ERA',  # eradicate
+    # 'FAST', # FastAPI
+    'YTT',  # flake8-2020
     'ANN', # flake8-annotations
+    'ASYNC', # flake8-async
     'S',   # flake8-bandit
     'BLE', # flake8-blind-except
+    # 'FBT',  # flake8-boolean-trap
     'B',   # flake8-bugbear
     'A',   # flake8-builtin
+    # 'COM',  # flake8-commas
     'C4',  # flake8-comprehensions
+    # 'CPY',  # flake8-copyright
     'DTZ', # flake8-datetimez
-    # 'EM',   # flake8-errmsg  # TODO
+    # 'T10',  # flake8-debugger
+    # 'DJ',   # flake8-django
+    # 'EM',   # flake8-errmsg
+    # 'EXE',  # flake8-executable
+    # 'FIX',  # flake8-fixme
     'FA',  # flake8-future-annotations
     'INT', # flake8-gettext
     'ISC', # flake8-implicit-str-concat
+    'ICN',  # flake8-import-conventions
     'LOG', # flake8-logging
-    # 'G',    # flake8-logging-format  # Prefer f-string to lazy `%` formatting and OK with '+'
+    'G',   # flake8-logging-format
+    # 'INP',  # flake8-no-pep420
     'PIE', # flake8-pie
+    # 'T20',  # flake8-print
     'PYI', # flake8-pyi
     'PT',  # flake8-pytest-style
     'Q',   # flake8-quotes
     'RSE', # flake8-raise
     'RET', # flake8-return
+    # 'SLF',  # flake8-self
     'SIM', # flake8-simplify
+    'SLOT', # flake8-slots
     'TID', # flake8-tidy-imports
     'TD',  # flake8-todos
     'TC',  # flake8-type-checking
@@ -286,29 +303,31 @@ select = [
     'FLY',  # flynt
     'I',    # isort
     'C90',  # mccabe
+    # 'NPY',  # NumPy-specific rules
+    # 'PD',   # pandas-vet
     'N',    # pep8-naming
     'PERF', # Perflint
     'E',    # pycodestyle errors
     'W',    # pycodestyle warnings
-    # 'DOC',  # pydoclint  # TODO
-    # 'D',    # pydocstyle  # TODO
+    # 'DOC',  # pydoclint (requires enabling preview, which turns on a TON of other stuff)
+    'D',    # pydocstyle
     'F', # Pyflakes
+    # 'PGH',  # pygrep-hooks
     # 'PL',   # Pylint  # TODO
+    'UP',   # pyupgrade
     'FURB', # refurb
     'RUF',  # Ruff-specific rules
     # 'TRY',  # tryceratops  # TODO
 ]
 
 ignore = [
-    'FLY002', # Consider f-string instead of string join
-    # 'G003',    # Logging statement uses `+`'
-    # 'G004',    # Logging statement uses f-string (Prefer f-string to lazy `%` formatting)
+    'D107',   # Missing docstring in __init__. Class-level docstring (D101) already covers the object's purpose.
+    'D203',   # Conflicts with D211, which forbids a blank line before a class docstring).
+    'D213',   # Conflicts with D212, which says multi-line docstring summary should start on the first line (Google style).
     'PLC0415', # `import` should be at the top-level of a file
-    'PT011',   # pytest.raises({exception}) is too broad, set the match parameter or use a more specific exception
     'PT030',   # pytest.warns({warning}) is too broad, set the match parameter or use a more specific warning
     'RUF012',  # Mutable class attributes should be annotated with `typing.ClassVar`
     'SIM105',  # Use contextlib.suppress({exception}) instead of try-except-pass
-    'SIM115',  # Use a context manager for opening files
     'TD002',   # Missing author in TODO
     'TD003',   # Missing issue link for this TODO
 ]
@@ -324,18 +343,24 @@ dummy-variable-rgx = '^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$'
 allowed-confusables = ['–', '‘', '’']
 
 [tool.ruff.lint.flake8-annotations]
-allow-star-arg-any = true # TODO
+allow-star-arg-any = true
 
 [tool.ruff.lint.flake8-quotes]
 inline-quotes = 'single'
 
 [tool.ruff.lint.mccabe]
 # Flag errors (`C901`) whenever the complexity level exceeds below.
-max-complexity = 30
+max-complexity = 20 # 10 is default, 13 to 15 is modern practice
 
 [tool.ruff.lint.per-file-ignores]
-'tests/*' = [
+'{tests/**,tools/test_*}' = [
+    'ANN401', #  Dynamically typed expressions (typing.Any) are disallowed
+    'PT011',   # pytest.raises({exception}) is too broad, set the match parameter or use a more specific exception
     'S101', # Use of `assert` detected
+    # Test functions are self-documenting:
+    'D101', # Missing docstring in public class
+    'D102', # Missing docstring in public method
+    'D103', # Missing docstring in public function
 ]
 
 [tool.ruff.lint.pydoclint]
@@ -382,14 +407,11 @@ docstring-code-line-length = 'dynamic'
 # -------------------------- ty --------------------------
 # Config file documentation at https://docs.astral.sh/ty/reference/configuration/
 
+# A ty.toml (e.g. one adding machine-specific interpreter paths) replaces this section entirely, so keep its other
+# settings the same as here. 'tools' is needed to resolve the scripts there that tests import after adding the
+# directory to sys.path at runtime (e.g. update_schema_hashes in tests/test_cli.py), which ty cannot follow.
 [tool.ty.environment]
-extra-paths = ['webchanges']
+extra-paths = ['webchanges', 'tools']
 
 [tool.ty.src]
-exclude = ["./webchanges/.**", "./webchanges/stora_minidb.py"]
-
-[[tool.ty.overrides]]
-include = ["./webchanges/storage/_minidb.py"]
-
-[tool.ty.overrides.rules]
-all = "ignore"
+exclude = ["./webchanges/.**", "./webchanges/storage/_minidb.py"]

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

@@ -1,7 +1,7 @@
 cssselect
 h2
 html2text
-httpx
+httpx2
 lxml
 markdown2
 msgpack

{webchanges-3.38.0 → webchanges-3.40.0}/setup.py

@@ -1,6 +1,8 @@
-# Shim required to wire argparse-manpage's build_manpages cmdclass into setuptools.
-# All other configuration lives in pyproject.toml.
-# See https://github.com/praiskup/argparse-manpage/blob/main/README.md
+"""Shim wiring argparse-manpage's ``build_manpages`` cmdclass into setuptools.
+
+All other configuration lives in pyproject.toml. See https://github.com/praiskup/argparse-manpage/blob/main/README.md
+"""
+
 from __future__ import annotations
 
 from build_manpages import build_manpages, get_build_py_cmd, get_install_cmd

{webchanges-3.38.0 → webchanges-3.40.0}/tools/get_manpages_parser.py

@@ -1,3 +1,5 @@
+"""Expose webchanges' argument parser to argparse-manpage."""
+
 from __future__ import annotations
 
 import sys
@@ -18,6 +20,5 @@ def get_manpages_parser() -> ArgumentParser:
 
     https://github.com/praiskup/argparse-manpage/blob/main/README.md
     """
-
     null_path = Path()
     return CommandConfig([], null_path, null_path, null_path, null_path, null_path).parse_args([])

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

@@ -1,6 +1,7 @@
-"""Checks web content, including images, to detect any changes since the prior run. If any are found,
-it summarizes (including with Gen AI) what changed ('diff') and displays it and/or sends it via email and/or other
-supported services. Can check the output of local commands as well.
+"""Checks web content, including images, to detect any changes since the prior run.
+
+If any are found, it summarizes (including with Gen AI) what changed ('diff') and displays it and/or sends it via email
+and/or other supported services. Can check the output of local commands as well.
 """
 
 # The code below is subject to the license contained in the LICENSE.md file, which is part of the source code.
@@ -22,7 +23,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.38.0'
+__version__ = '3.40.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-3.40.0}/webchanges/__main__.py

@@ -1,3 +1,5 @@
+"""Run webchanges with ``python -m webchanges``."""
+
 if __name__ == '__main__':
     import sys
     from pathlib import Path

webchanges-3.40.0/webchanges/_httpx.py

@@ -0,0 +1,37 @@
+"""The primary HTTP client: ``httpx2``, else ``httpx`` (same API) imported as ``httpx2``, else ``None``.
+
+Modules get the client from here (``from webchanges._httpx import httpx2``) so that the choice is made in one place.
+If neither is installed, ``requests`` and then ``curl_cffi`` are used instead (see ``UrlJob._select_http_client()`` in
+``webchanges/jobs/_url.py``), so every use of ``httpx2`` must be guarded with ``if httpx2 is None`` / ``if httpx2``.
+"""
+
+# The code below is subject to the license contained in the LICENSE.md file, which is part of the source code.
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+__all__ = ['Headers', 'h2', 'httpx2']
+
+# The fallback assignments below are hidden from the type checker behind `if not TYPE_CHECKING`. Otherwise the type
+# checker infers the union of all bindings (e.g. `<module 'httpx2'> | None`), and every reference to a module
+# attribute — including in annotations such as `httpx2.Response`, which cannot be guarded at runtime — is reported as
+# unresolved. Hiding the fallbacks keeps the httpx2 module type, which is what these code paths are guarded to run
+# under.
+try:
+    import httpx2
+    from httpx2 import Headers
+except ImportError:  # pragma: no cover
+    if not TYPE_CHECKING:
+        try:
+            import httpx as httpx2
+            from httpx import Headers
+        except ImportError:
+            httpx2 = None
+            from webchanges._vendored.headers import Headers
+
+# HTTP/2 support (used only by the client above).
+try:
+    import h2
+except ImportError:  # pragma: no cover
+    h2 = None

webchanges-3.40.0/webchanges/_resources/.config.schema.sha256

@@ -0,0 +1 @@
+314f226aa22b4e546970df26dc47aa9bbd4ae170c67fabe9610f040f2d3f345e

webchanges-3.40.0/webchanges/_resources/.jobs.schema.sha256

@@ -0,0 +1 @@
+5b3c2a1db96278aefcb4a20acf1442a321b9c5c84711da1dc1751ca714a0d8ea