1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
# MailWebsiteChanges
Python script to keep track of website changes; sends email notifications on updates and/or also provides an RSS feed
To specify which parts of a website should be monitored, <b>XPath selectors</b> (e.g. "//h1"), <b>CSS selectors</b> (e.g. "h1"), <b>and regular expressions can be used</b> (just choose the tools you like!).
MailWebsiteChanges is related to <a href="http://code.google.com/p/pagemon-chrome-ext/">PageMonitor</a> for Chrome and <a href="https://addons.mozilla.org/de/firefox/addon/alertbox/">AlertBox</a> / <a href="https://addons.mozilla.org/de/firefox/addon/check4change/">Check4Change</a> for Firefox. However, instead of living in your web browser, you can run it independently from command line / bash and install it as a simple cron job running on your linux server.
<i>This is Open Source -- so please contribute eagerly! ;-)</i>
## Configuration
Configuration can be done by creating a <code>config.py</code> file (just place this file in the program folder):
Some examples:
### Website definitions
<pre>
<code>
sites = [
{'shortname': 'mywebsite1',
'uri': 'http://www.mywebsite1.com/info',
'contentcss': 'div'},
{'shortname': 'mywebsite2',
'uri': 'http://www.mywebsite2.com/info',
'contentxpath': '//*[contains(concat(\' \', normalize-space(@class), \' \'), \' news-list-container \')]',
'titlexpath': '//title'},
{'shortname': 'mywebsite3',
'uri': 'http://www.mywebsite3.com/info',
'type': 'text',
'contentregex': 'Version\"\:\d*\.\d*',
'user-agent': 'Mozilla/5.0 (X11; Fedora; Linux x86_64; rv:49.0) Gecko/20100101 Firefox/49.0'}
]
</code>
</pre>
* parameters:
* <b>shortname</b>
short name of the entry, used as an identifier when sending email notifications
* <b>uri</b>
URI of the website; If the scheme of the uri is 'cmd://', the string is interpreted as a command and the standard output (stdout) is parsed.
* <b>type</b> (optional; default: 'html')
content type, e.g., 'xml'/'html'/'text'.
* <b>contentxpath</b> / <b>titlexpath</b> (optional)
XPath expression for the content/title sections to extract. If you prefer, you could use contentcss/titlecss instead.
* <b>contentcss</b> / <b>titlecss</b> (optional)
CSS expression for the content/title sections to extract. This is ignored if there is a corresponding XPath definition.
* <b>contentregex</b> / <b>titleregex</b> (optional)
Regular expression. If XPath/CSS selector is defined, the regular expression is applied afterwards.
* <b>encoding</b> (optional; default: 'utf-8')
Character encoding of the website, e.g., 'utf-8' or 'iso-8859-1'.
* <b>receiver</b> (optional)
Overrides global receiver specification.
* <b>user-agent</b> (optional)
Defines the user agent string, e.g.,
'user-agent': 'Mozilla/5.0 (X11; Fedora; Linux x86_64; rv:49.0) Gecko/20100101 Firefox/49.0'
* <b>accept</b> (optional)
Defines the accept string, e.g.,
'accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8'
* We collect some XPath/CSS snippets at this place: <a href="https://github.com/Debianguru/MailWebsiteChanges/wiki/snippets">Snippet collection</a> - please feel free to add your own definitions!
* The <b>--dry-run="shortname"</b> option might be useful in order to validate and fine-tune a definition.
* If you would like to keep the data stored in a different place than the working directory, you can include something like this:
<pre>
<code>
os.chdir('/path/to/data/directory')
</code>
</pre>
### Mail settings
<pre>
<code>
enableMailNotifications = True #enable/disable notification messages; if set to False, only send error messages
subjectPostfix = 'A website has been updated!'
sender = 'me@mymail.com'
smtphost = 'mysmtpprovider.com'
useTLS = True
smtpport = 587
smtpusername = sender
smtppwd = 'mypassword'
receiver = 'me2@mymail.com' # set to '' to also disable notifications in case of errors (not recommended)
</code>
</pre>
### RSS Feeds
If you prefer to use the RSS feature, you just have to specify the path of the feed file which should be generated by the script (e.g., rssfile = 'feed.xml') and then point your webserver to that file. You can also invoke the mwcfeedserver.py script which implements a very basic webserver.
<pre>
<code>
enableRSSFeed = True #enable/disable RSS feed
rssfile = 'feed.xml'
maxFeeds = 100
</code>
</pre>
### Program execution
To setup a job that periodically runs the script, simply attach something like this to your /etc/crontab:
<pre>
<code>
0 8-22/2 * * * root /usr/bin/python3 /usr/bin/mwc
</code>
</pre>
This will run the script every two hours between 8am and 10pm.
If you prefer invoking the script with an alternate configuration files, simply pass the name of the configuration file as an argument, e.g., for <code>my_alternate_config.py</code>, use <code>mwc --config=my_alternate_config</code>.
## Requirements
Requires Python 3, <a href="http://lxml.de/">lxml</a>, and <a href="http://pythonhosted.org/cssselect/">cssselect</a>.
For <b>Ubuntu 12.04</b>, type:
* sudo apt-get install python3 python3-dev python3-setuptools libxml2 libxslt1.1 libxml2-dev libxslt1-dev python-libxml2 python-libxslt1
* sudo easy\_install3 pip
* sudo pip-3.2 install lxml cssselect
For <b>Ubuntu 14.04</b>, type:
* sudo apt-get install python3-lxml python3-pip
* sudo pip3 install cssselect
|
