Skip to main content

Check web (or commands) for changes since last run and notify.

Project description

webchanges checks web content (or the output of local commands) for changes, and notifies you via e-mail or one of many other supported services if one is detected. The notification includes the changed URL or command and a summary of what has changed. This project is a fork of urlwatch as suggested by its author to optimize it for HTML.

Installation

webchanges pypi version is available on PyPI for supported Python version (Python versions are supported for 3 years after being obsoleted by a new major release) and can be installed using pip:

pip install webchanges

Documentation

The documentation is hosted on Read the Docs Read the documentation at https://webchanges.readthedocs.io/.

Code

code coverage by Coveralls issues

The code and issues tracker are hosted on GitHub.

Quick Start

  1. Run webchanges --edit to customize your jobs list (this will also create jobs.yaml and config.yaml)

  2. Run webchanges --edit-config if you want to set up e.g. e-mail sending

webchanges checks for changes every time you run it, but does not include a scheduler. We recommend using a system scheduler to automatically run webchanges periodically:

  • On Linux/MacOS, you can use cron; crontab.guru will build a schedule expression for you; if you have never used cron before, see here

  • On Windows, you can use the built-in Windows Task Scheduler

Contributing

We welcome any contribution, e.g. documentation, bug reports, new features, etc., as both pull requests and issues. More information for developers and documenters is here, and our wishlist is here.

License

license

Released under the MIT License, but including code licensed under the BSD 3-Clause License. See the license here.

Improvements from urlwatch

You can seamlessly upgrade from urlwatch 2.23 (see here) and benefit from these HTML-focused improvements:

  • Links are clickable!

  • Formatting such as bolding / headers, italics, underlining, list bullets (•) and indentation is preserved

  • Uses color and strikethrough to highlight added and deleted lines.,and long lines wrap around

  • HTML is rendered correctly by email clients who override stylesheets (e.g. Gmail)

  • Other legibility improvements

  • Multiple changes to how Pyppeteer is run (for websites that need JavaScript rendering before capture) increasing stability, reliability, flexibility and control

  • New filters such as additions_only, which makes it easier to track content that was added without the distractions of the content that was deleted

  • Better documentation

  • More reliability and stability, including a 22 percentage point increase in testing coverage

  • Many many other additions, refinements and fixes (see detailed information)

Examples:

https://raw.githubusercontent.com/mborsetti/webchanges/main/docs/html_diff_filters_example_1.png

https://raw.githubusercontent.com/mborsetti/webchanges/main/docs/html_diff_filters_example_3.png

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

webchanges-3.5.0-py3-none-any.whl (69.0 kB view details)

Uploaded Python 3

File details

Details for the file webchanges-3.5.0-py3-none-any.whl.

File metadata

  • Download URL: webchanges-3.5.0-py3-none-any.whl
  • Upload date:
  • Size: 69.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.4

File hashes

Hashes for webchanges-3.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d113383c54df2e695c6ed15505ad1b522b4c338d2d358c8fa25d372771a3856c
MD5 3fa0269689fc8f0ae87e0cd03728ee2d
BLAKE2b-256 82399608d0b9840a3cc6797796eb919dbf6853d82d5134fd6d939098b169e39a

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page