cupage.py¶

Check for updates on web pages¶

Author:	James Rowe <jnrowe@gmail.com>
Date:	2010-01-23
Copyright:	GPL v3
Manual section:	1
Manual group:	Networking

SYNOPSIS¶

cupage.py [option]... <command>

DESCRIPTION¶

cupage checks web pages and displays changes from the last run that match a given criteria. Its original purpose was to check web pages for new software releases, but it is easily configurable and can be used for other purposes.

OPTIONS¶

`--version`	show program’s version number and exit
`-h, --help`	show this help message and exit
`-v, --verbose`	produce verbose output
`-q, --quiet`	output only matches and errors

COMMANDS¶

`add`¶

Add definition to config file

`-f <file>, --config <file>`
	configuration file to read
`-s <site>, --site <site>`
	site helper to use
`-u <url>, --url <url>`
	site url to check
`-t <type>, --match-type <type>`
	pre-defined regular expression to use
`-m <regex>, --match <regex>`
	regular expression to use with –match-type=re
`-q <frequency>, --frequency <frequency>`
	update check frequency
`-x <selector>, --select <selector>`
	content selector
`--selector <type>`
	selector method to use

`check`¶

Check sites for updates

`-f <file>, --config <file>`
	configuration file to read
`-d <file>, --database <file>`
	database to store page data to. Default based on `cupage check -f` value, for example `--config my_conf` will result in a default setting of `--database my_conf.db`. See Database for details of the database format.
`-c <dir>, --cache <dir>`
	directory to store page cache This can, and in fact should be, shared between all cupage uses.
`--no-write`	don’t update cache or database
`--force`	ignore frequency checks
`-t <n>, --timeout=<n>`
	timeout for network operations

`list`¶

List definitions from config file

`-f <file>, --config <file>`
	configuration file to read
`-m <regex>, --match <regex>`
	match sites using regular expression

`list-sites`¶

List supported site values

`remove`¶

Remove site from config

`-f <file>, --config <file>`
	configuration file to read

CONFIGURATION FILE¶

The configuration file, by default ~/.cupage.conf, is a simple INI format file, with sections defining sites to check. For example:

[spill]
url = http://www.rpcurnow.force9.co.uk/spill/index.html
select = p a
[rails]
site = vim-script
script = 1567

With the above configuration file the site named spill will be checked at http://www.rpcurnow.force9.co.uk/spill/index.html, and elements matching the CSS selector p a will be scanned for tarballs. The site named rails will be checked using the vim-script site matcher, which requires only a script value to check for updates in the scripts section of http://www.vim.org.

Various site matchers are available, see the output of cupage.py --list-sites.

BUGS¶

None known.

AUTHOR¶

Written by James Rowe

RESOURCES¶

Home page: http://github.com/JNRowe/cupage

COPYING¶

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.