projects.mako.cc - mw/blob - src/mw/api.py

   1 ###
   2 # mw - VCS-like nonsense for MediaWiki websites
   3 # Copyright (C) 2010  Ian Weller <ian@ianweller.org>
   4 #
   5 # This program is free software; you can redistribute it and/or modify
   6 # it under the terms of the GNU General Public License as published by
   7 # the Free Software Foundation; either version 2 of the License, or
   8 # (at your option) any later version.
   9 #
  10 # This program is distributed in the hope that it will be useful,
  11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 # GNU General Public License for more details.
  14 #
  15 # You should have received a copy of the GNU General Public License along
  16 # with this program.  If not, see <http://www.gnu.org/licenses/>.
  17 ###
  18
  19 import cookielib
  20 import gzip
  21 import json
  22 import mw.metadir
  23 import os
  24 from StringIO import StringIO
  25 import urllib
  26 import urllib2
  27
  28
  29 class API(object):
  30
  31     def __init__(self, api_url, metadir):
  32         self.api_url = api_url
  33         self.metadir = metadir
  34         self.cookiejar = cookielib.MozillaCookieJar(os.path.join(
  35                 self.metadir.location, 'cookies'))
  36         try:
  37             self.cookiejar.load()
  38         except IOError:
  39             self.cookiejar.save()
  40             self.cookiejar.load()
  41         self.opener = urllib2.build_opener(
  42                 urllib2.HTTPCookieProcessor(self.cookiejar))
  43         self._high_limits = None
  44
  45     def call(self, data):
  46         data['format'] = 'json'
  47         request = urllib2.Request(self.api_url, urllib.urlencode(data))
  48         request.add_header('Accept-encoding', 'gzip')
  49         response = self.opener.open(request)
  50         self.cookiejar.save()
  51         if response.headers.get('Content-Encoding') == 'gzip':
  52             compressed = StringIO(response.read())
  53             gzipper = gzip.GzipFile(fileobj=compressed)
  54             data = gzipper.read()
  55         else:
  56             data = response.read()
  57         the_data = json.loads(data)
  58         if 'error' in the_data.keys():
  59             raise APIError(the_data['error']['info'])
  60         return the_data
  61
  62     def limits(self, low, high):
  63         if self._high_limits == None:
  64             result = self.call({'action': 'query',
  65                                 'meta': 'userinfo',
  66                                 'uiprop': 'rights'})
  67             self._high_limits = 'apihighlimits' in \
  68                     result['query']['userinfo']['rights']
  69         if self._high_limits:
  70             return high
  71         else:
  72             return low
  73
  74
  75 class APIError(Exception):
  76
  77     def __init__(self, info):
  78         self.info = info
  79
  80     def __str__(self):
  81         return self.info
  82
  83
  84 def pagename_to_filename(name):
  85     name = name.replace(' ', '_')
  86     name = name.replace('/', '!')
  87     return name
  88
  89
  90 def filename_to_pagename(name):
  91     name = name.replace('!', '/')
  92     name = name.replace('_', ' ')
  93     return name