PyPI 官网下载 | leagueoflegends-0.12.macosx-10.8-x86_64.tar.gz

#!/usr/bin/python # -*- coding: utf-8 -*- """ Python library for the League of Legends official API Copyright (c) 2013 Jennie Lees <[email protected]> The LoL API belongs to Riot and can be found here: https://developer.riotgames.com/ This product is not endorsed, certified or otherwis approved in any way by Riot Games, Inc. or any of its affiliates. """ __author__ = 'Jennie Lees' __version__ = '0.1' import urllib2 import json import unicodedata import re class LeagueOfLegends: API_BASE_URL = 'https://prod.api.pvp.net/api/lol' api_version = '1.2' api_region = 'na' api_url = API_BASE_URL + '/' + api_region + '/' + 'v' + api_version + '/' def __init__(self, api_key, cache={}): self.api_key = api_key self.__cache = cache def __webrequest(self, url): # print 'Making request to: ' + url try: opener = urllib2.build_opener(NotModifiedHandler()) req = urllib2.Request(url) if url in self.__cache: # Return summoner detail URLs from cache explicitly # to avoid repeated API calls if url.find('summoner/by-name'): return self.__cache[url]['response'] if 'etag' in self.__cache[url]: print 'Adding ETag to request header: '\ + self.__cache[url]['etag'] req.add_header('If-None-Match', self.__cache[url]['etag']) if 'last_modified' in self.__cache[url]: print 'Adding Last-Modified to request header: '\ + self.__cache[url]['last_modified'] req.add_header('If-Modified-Since', self.__cache[url]['last_modified']) url_handle = opener.open(req) if hasattr(url_handle, 'code') and url_handle.code == 304: print 'Got 304 response, no body send' return self.__cache[url]['response'] else: headers = url_handle.info() response = url_handle.read() cache_data = { 'response': response, 'url': url.replace('?api_key=' + self.api_key, '')} if headers.getheader('Last-Modified'): cache_data['last_modified'] = headers.getheader('Last-Modified') if headers.getheader('ETag'): cache_data['etag'] = headers.getheader('ETag').replace('"', '') self.__cache[url] = cache_data return response except urllib2.HTTPError, e: # You should surround your code with try/catch that looks for a HTTPError # code 429 -- this is a rate limit error from Riot. # print 'HTTPError calling ' + url raise RiotError(e.code) return None def get_cache(self, url=None): if url is not None: return self.__cache[url] else: return self.__cache def set_api_region(self, region): if region is not None: if region.lower() in ['na', 'euw', 'eune', 'br', 'tr']: self.api_region = region.lower() self.update_api_url() return self.api_url else: return None def set_api_version(self, version): if version is not None: self.api_version = version self.update_api_url() return self.api_url def update_api_url(self): self.api_url = self.API_BASE_URL + '/' + self.api_region + '/' + 'v' + self.api_version + '/' # print self.api_url def __getjsondata(self, namespace, query=''): query = query.replace(' ', '+') query = unicodedata.normalize('NFKD', query.decode('utf-8')) \ .encode('ascii', 'ignore') url = self.api_url + namespace + query + '.js?api_key='\ + self.api_key response = self.__webrequest(url) if response is not None: response = json.loads(response, strict=False) return response def get_data(self, namespace, query=''): result = self.__getjsondata(namespace, '/%s' % query) return result def get_champions(self, free_to_play=False): # Champion API is version 1.1 only self.set_api_version('1.1') url = self.api_url + 'champion?api_key=' + self.api_key + '&freeToPlay=' + str(free_to_play) response = json.loads(self.__webrequest(url)) return response["champions"] def get_summoner_games(self, summoner_id=None): if summoner_id is None: if self.summoner_id is not None: summoner_id = self.summoner_id else: return self.set_api_version('1.2') url = self.api_url + 'game/by-summoner/%s/recent?api_key=%s' % (summoner_id, self.api_key) response = json.loads(self.__webrequest(url)) return response["games"] def get_summoner_leagues(self, summoner_id=None): if summoner_id is None: if self.summoner_id is not None: summoner_id = self.summoner_id else: return self.set_api_version('2.2') url = self.api_url + 'league/by-summoner/%s?api_key=%s' % (summoner_id, self.api_key) response = json.loads(self.__webrequest(url)) # Return data with more useful keys based on league type remapped_league = {} for league in response: remapped_league[response[league]["queue"]] = response[league] return remapped_league def get_summoner_stats(self, summoner_id=None, season=None): if summoner_id is None: if self.summoner_id is not None: summoner_id = self.summoner_id else: return self.set_api_version('1.2') url = self.api_url + 'stats/by-summoner/%s/summary?api_key=%s' % (summoner_id, self.api_key) response = json.loads(self.__webrequest(url)) if response["summonerId"] != summoner_id: raise DataMismatchError return response["playerStatSummaries"] def get_summoner_ranked_stats(self, summoner_id=None, season=None): if summoner_id is None: if self.summoner_id is not None: summoner_id = self.summoner_id else: return self.set_api_version('1.2') url = self.api_url + 'stats/by-summoner/%s/ranked?api_key=%s' % (summoner_id, self.api_key) response = json.loads(self.__webrequest(url)) if response["summonerId"] != summoner_id: raise DataMismatchError # response["modifyDate"] is also returned, but assuming developers would be tracking # separately, though there could be some use-cases around delta stats. return response["champions"] def get_summoner_by_id(self, summoner_id=None): if summoner_id is None: if self.summoner_id is not None: summoner_id = self.summoner_id else: return self.set_api_version('1.2') url = self.api_url + 'summoner/%s?api_key=%s' % (summoner_id, self.api_key) response = json.loads(self.__webrequest(url)) return response def get_summoner_by_name(self, summoner_name): if summoner_name == '': return self.set_api_version('1.2') url = self.api_url + 'summoner/by-name/%s?api_key=%s' % (summoner_name, self.api_key) response = json.loads(self.__webrequest(url)) return response def get_summoner_id_from_name(self, summoner_name): return self.get_summoner_by_name(summoner_name)["id"] def get_summoner_name_from_id(self, summoner_id): return self.get_summoner_by_id(summoner_id)["name"] def get_su