Revision: 8171
Author: russblau
Date: 2010-05-14 19:11:51 +0000 (Fri, 14 May 2010)
Log Message:
-----------
Add hook for watching, unwatching pages.
Modified Paths:
--------------
branches/rewrite/pywikibot/site.py
Modified: branches/rewrite/pywikibot/site.py
===================================================================
--- branches/rewrite/pywikibot/site.py 2010-05-14 18:53:39 UTC (rev 8170)
+++ branches/rewrite/pywikibot/site.py 2010-05-14 19:11:51 UTC (rev 8171)
@@ -2584,6 +2584,25 @@
#TODO: implement patrol
+ def watchpage(self, page, unwatch=False):
+ """Add or remove page from watchlist.
+
+ @param unwatch: If True, remove page from watchlist; if False (default),
+ add it.
+ @return: True if API returned expected response; False otherwise
+
+ """
+ req = api.Request(action="watch", title=page.title(withSection=False))
+ if unwatch:
+ req["unwatch"] = ""
+ result = req.submit()
+ if "watch" not in result:
+ pywikibot.error(u"watchpage: Unexpected API response:\n%s" %
result)
+ return False
+ watched = result["watch"]
+ return ((unwatch and "unwatched" in watched)
+ or (not unwatch and "watched" in result))
+
@deprecated("Site().exturlusage")
def linksearch(self, siteurl, limit=None):
"""Backwards-compatible interface to
exturlusage()"""
Show replies by date