Skip to main content

Check web (or commands) for changes since last run and notify. Anonymously alerts you of webpage changes.

Project description

webchanges checks web content and notifies you via e-mail (or one of many other supported services) if a change is detected. webchanges can also check the output of local commands. 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.

webchanges anonymously alerts you of webpage changes.

Requirements

webchanges requires Supported Python versions.

You should use the latest version of Python if possible. If you’re using an older version, be aware that for each minor version (3.x), only the latest bugfix release (3.x.y) is supported. Older Python versions are supported for 3 years beyond being obsoleted by a new major release.

Installation

Install webchanges PyPI version Kit format Package stability with:

pip install webchanges

Documentation

The documentation is hosted on Read the Docs Documentation status.

Quick Start

Initialize

  1. Run the following command to create the default config.yaml (configuration) and jobs.yaml (jobs) files and open an editor to add your jobs:

    webchanges --edit
  2. Run the following command to change the default configuration, e.g. to receive change notifications (“reports”) by e-mail and/or one of many other methods:

    webchanges --edit-config

Run

To check the sources in your jobs and report on (e.g. display or via e-mail) any changes found from the previous execution, just run:

webchanges

webchanges does not include a scheduler. We recommend using a system scheduler to automatically run webchanges periodically:

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

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

Code

Code coverage by Coveralls Issues at https://github.com/mborsetti/webchanges/issues

The code and issues tracker are hosted on GitHub.

Contributing

We welcome any contribution, e.g. documentation, bug reports, new features, etc., as both pull requests and issue reports.

More information for developers and documentation editors is here, and our wishlist is here.

License

License at https://pypi.org/project/webchanges/

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

Improvements from urlwatch

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

  • Report links that are clickable!

  • Original formatting such as bolding / headers, italics, underlining, list bullets (•) and indentation;

  • Added and deleted lines clearly highlighted by color and strikethrough, and long lines that wrap around;

  • Correct rendering 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;

  • Much better documentation;

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

  • 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

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.9-py3-none-any.whl (95.2 kB view hashes)

Uploaded Python 3

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