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

   1 ###
   2 # mw - VCS-like nonsense for MediaWiki websites
   3 # Copyright (C) 2009  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 from StringIO import StringIO
  23 import urllib
  24 import urllib2
  25
  26 class API(object):
  27     def __init__(self, api_url):
  28         self.api_url = api_url
  29         self.cookiejar = cookielib.CookieJar()
  30         self.opener = urllib2.build_opener(
  31                 urllib2.HTTPCookieProcessor(self.cookiejar))
  32         self._high_limits = None
  33
  34     def call(self, data):
  35         data['format'] = 'json'
  36         request = urllib2.Request(self.api_url, urllib.urlencode(data))
  37         request.add_header('Accept-encoding', 'gzip')
  38         response = self.opener.open(request)
  39         if response.headers.get('Content-Encoding') == 'gzip':
  40             compressed = StringIO(response.read())
  41             gzipper = gzip.GzipFile(fileobj=compressed)
  42             data = gzipper.read()
  43         else:
  44             data = response.read()
  45         return json.loads(data)
  46
  47     def limits(self, low, high):
  48         if self._high_limits == None:
  49             result = self.call({'action': 'query',
  50                                 'meta': 'userinfo',
  51                                 'uiprop': 'rights'})
  52             self._high_limits = 'apihighlimits' in \
  53                     result['query']['userinfo']['rights']
  54         if self._high_limits:
  55             return high
  56         else:
  57             return low
  58
  59
  60 def pagename_to_filename(name):
  61     name = name.replace(' ', '_')
  62     name = name.replace('/', '!')
  63     return name
  64
  65 def filename_to_pagename(name):
  66     name = name.replace('!', '/')
  67     name = name.replace('_', ' ')
  68     return name