page-update-monitor 1.0.2

CLI tool to monitor web page updates

Page Update Monitor

---

Quick Start

pip install page-update-monitor
pum add
pum check

---

A simple CLI tool to monitor web page updates. Register any web page and check whether it has changed since the last time you checked. You can monitor the entire page or specific elements using CSS selectors.

• Page Update Monitor
  • Quick Start
  • Features
  • Installation
  • Usage
  • Commands
    • See help
    • Check for updates
    • Add a website
    • List websites
    • Remove a website
    • Show version
  • How It Works
  • Data Storage
  • Example Workflow
  • Requirements
  • Dependencies
  • Development

---

Features

• Monitor full web pages for changes
• Monitor specific elements using CSS selectors
• Simple and intuitive CLI
• Lightweight (no browser required)
• Local JSON storage (no database needed)

---

Installation

Install via pip:

pip install page-update-monitor

---

Usage

pum [COMMAND]

Check version:

pum --version
pum -v

---

Commands

See help

pum --help

---

Check for updates

pum check

Checks all registered websites and reports changes.

---

Add a website

pum add

You will be prompted to enter:

• Site name (any name you like, used locally to identify the site)

• URL

• Mode:

  • full (default): monitor the entire page
  • selector: monitor a specific HTML element

If you choose selector mode, enter a CSS selector.

Examples:

#main
.content

The tool will validate the selector and show a preview:

[OK] #main -> <content preview>...

---

List websites

pum list

With details:

pum list -d

---

Remove a website

pum remove [name]

Alias:

pum rm [name]

Example:

pum rm example-site

---

Show version

pum version

Or:

pum --version
pum -v

---

How It Works

• Fetches HTML using requests
• Parses content with BeautifulSoup
• Stores previous results locally
• Compares current content with the last snapshot

If a difference is detected, it reports an update.

---

Data Storage

Configuration files are stored in the user config directory:

• Linux: ~/.config/page-update-monitor/
• macOS: ~/Library/Application Support/page-update-monitor/
• Windows: %APPDATA%/page-update-monitor/

---

Example Workflow

pum add
pum list
pum check

---

Requirements

• Python 3.10+

---

Dependencies

• typer
• requests
• beautifulsoup4
• rich

---

Development

Clone the repository:

git clone https://github.com/yourname/page-update-monitor.git
cd page-update-monitor
pip install -e .