--- /dev/null
+#! /usr/bin/env python
+#
+# pyfacebook - Python bindings for the Facebook API
+#
+# Copyright (c) 2008, Samuel Cormier-Iijima
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+# * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution.
+# * Neither the name of the author nor the names of its contributors may
+# be used to endorse or promote products derived from this software
+# without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS``AS IS'' AND ANY
+# EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY
+# DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""
+Python bindings for the Facebook API (pyfacebook - http://code.google.com/p/pyfacebook)
+
+PyFacebook is a client library that wraps the Facebook API.
+
+For more information, see
+
+Home Page: http://code.google.com/p/pyfacebook
+Developer Wiki: http://wiki.developers.facebook.com/index.php/Python
+Facebook IRC Channel: #facebook on irc.freenode.net
+
+PyFacebook can use simplejson if it is installed, which
+is much faster than XML and also uses less bandwith. Go to
+http://undefined.org/python/#simplejson to download it, or do
+apt-get install python-simplejson on a Debian-like system.
+"""
+
+import md5
+import sys
+import time
+import struct
+import urllib
+import urllib2
+import httplib
+import hashlib
+import binascii
+import urlparse
+import mimetypes
+
+# try to use simplejson first, otherwise fallback to XML
+RESPONSE_FORMAT = 'JSON'
+try:
+ import simplejson
+except ImportError:
+ try:
+ import json as simplejson
+ except ImportError:
+ try:
+ from django.utils import simplejson
+ except ImportError:
+ try:
+ import jsonlib as simplejson
+ simplejson.loads
+ except (ImportError, AttributeError):
+ from xml.dom import minidom
+ RESPONSE_FORMAT = 'XML'
+
+# support Google App Engine. GAE does not have a working urllib.urlopen.
+try:
+ from google.appengine.api import urlfetch
+
+ def urlread(url, data=None, headers=None):
+ if data is not None:
+ if headers is None:
+ headers = {"Content-type": "application/x-www-form-urlencoded"}
+ method = urlfetch.POST
+ else:
+ if headers is None:
+ headers = {}
+ method = urlfetch.GET
+
+ result = urlfetch.fetch(url, method=method,
+ payload=data, headers=headers)
+
+ if result.status_code == 200:
+ return result.content
+ else:
+ raise urllib2.URLError("fetch error url=%s, code=%d" % (url, result.status_code))
+
+except ImportError:
+ def urlread(url, data=None):
+ res = urllib2.urlopen(url, data=data)
+ return res.read()
+
+__all__ = ['Facebook']
+
+VERSION = '0.1'
+
+FACEBOOK_URL = 'http://api.facebook.com/restserver.php'
+FACEBOOK_SECURE_URL = 'https://api.facebook.com/restserver.php'
+
+class json(object): pass
+
+# simple IDL for the Facebook API
+METHODS = {
+ 'application': {
+ 'getPublicInfo': [
+ ('application_id', int, ['optional']),
+ ('application_api_key', str, ['optional']),
+ ('application_canvas_name ', str,['optional']),
+ ],
+ },
+
+ # admin methods
+ 'admin': {
+ 'getAllocation': [
+ ('integration_point_name', str, []),
+ ],
+ },
+
+ # feed methods
+ 'feed': {
+ 'publishStoryToUser': [
+ ('title', str, []),
+ ('body', str, ['optional']),
+ ('image_1', str, ['optional']),
+ ('image_1_link', str, ['optional']),
+ ('image_2', str, ['optional']),
+ ('image_2_link', str, ['optional']),
+ ('image_3', str, ['optional']),
+ ('image_3_link', str, ['optional']),
+ ('image_4', str, ['optional']),
+ ('image_4_link', str, ['optional']),
+ ('priority', int, ['optional']),
+ ],
+
+ 'publishActionOfUser': [
+ ('title', str, []),
+ ('body', str, ['optional']),
+ ('image_1', str, ['optional']),
+ ('image_1_link', str, ['optional']),
+ ('image_2', str, ['optional']),
+ ('image_2_link', str, ['optional']),
+ ('image_3', str, ['optional']),
+ ('image_3_link', str, ['optional']),
+ ('image_4', str, ['optional']),
+ ('image_4_link', str, ['optional']),
+ ('priority', int, ['optional']),
+ ],
+
+ 'publishTemplatizedAction': [
+ ('title_template', str, []),
+ ('page_actor_id', int, ['optional']),
+ ('title_data', json, ['optional']),
+ ('body_template', str, ['optional']),
+ ('body_data', json, ['optional']),
+ ('body_general', str, ['optional']),
+ ('image_1', str, ['optional']),
+ ('image_1_link', str, ['optional']),
+ ('image_2', str, ['optional']),
+ ('image_2_link', str, ['optional']),
+ ('image_3', str, ['optional']),
+ ('image_3_link', str, ['optional']),
+ ('image_4', str, ['optional']),
+ ('image_4_link', str, ['optional']),
+ ('target_ids', list, ['optional']),
+ ],
+
+ 'registerTemplateBundle': [
+ ('one_line_story_templates', json, []),
+ ('short_story_templates', json, ['optional']),
+ ('full_story_template', json, ['optional']),
+ ('action_links', json, ['optional']),
+ ],
+
+ 'deactivateTemplateBundleByID': [
+ ('template_bundle_id', int, []),
+ ],
+
+ 'getRegisteredTemplateBundles': [],
+
+ 'getRegisteredTemplateBundleByID': [
+ ('template_bundle_id', str, []),
+ ],
+
+ 'publishUserAction': [
+ ('template_bundle_id', int, []),
+ ('template_data', json, ['optional']),
+ ('target_ids', list, ['optional']),
+ ('body_general', str, ['optional']),
+ ],
+ },
+
+ # fql methods
+ 'fql': {
+ 'query': [
+ ('query', str, []),
+ ],
+ },
+
+ # friends methods
+ 'friends': {
+ 'areFriends': [
+ ('uids1', list, []),
+ ('uids2', list, []),
+ ],
+
+ 'get': [
+ ('flid', int, ['optional']),
+ ],
+
+ 'getLists': [],
+
+ 'getAppUsers': [],
+ },
+
+ # notifications methods
+ 'notifications': {
+ 'get': [],
+
+ 'send': [
+ ('to_ids', list, []),
+ ('notification', str, []),
+ ('email', str, ['optional']),
+ ('type', str, ['optional']),
+ ],
+
+ 'sendRequest': [
+ ('to_ids', list, []),
+ ('type', str, []),
+ ('content', str, []),
+ ('image', str, []),
+ ('invite', bool, []),
+ ],
+
+ 'sendEmail': [
+ ('recipients', list, []),
+ ('subject', str, []),
+ ('text', str, ['optional']),
+ ('fbml', str, ['optional']),
+ ]
+ },
+
+ # profile methods
+ 'profile': {
+ 'setFBML': [
+ ('markup', str, ['optional']),
+ ('uid', int, ['optional']),
+ ('profile', str, ['optional']),
+ ('profile_action', str, ['optional']),
+ ('mobile_fbml', str, ['optional']),
+ ('profile_main', str, ['optional']),
+ ],
+
+ 'getFBML': [
+ ('uid', int, ['optional']),
+ ('type', int, ['optional']),
+ ],
+
+ 'setInfo': [
+ ('title', str, []),
+ ('type', int, []),
+ ('info_fields', json, []),
+ ('uid', int, []),
+ ],
+
+ 'getInfo': [
+ ('uid', int, []),
+ ],
+
+ 'setInfoOptions': [
+ ('field', str, []),
+ ('options', json, []),
+ ],
+
+ 'getInfoOptions': [
+ ('field', str, []),
+ ],
+ },
+
+ # users methods
+ 'users': {
+ 'getInfo': [
+ ('uids', list, []),
+ ('fields', list, [('default', ['name'])]),
+ ],
+
+ 'getStandardInfo': [
+ ('uids', list, []),
+ ('fields', list, [('default', ['uid'])]),
+ ],
+
+ 'getLoggedInUser': [],
+
+ 'isAppAdded': [],
+
+ 'hasAppPermission': [
+ ('ext_perm', str, []),
+ ('uid', int, ['optional']),
+ ],
+
+ 'setStatus': [
+ ('status', str, []),
+ ('clear', bool, []),
+ ('status_includes_verb', bool, ['optional']),
+ ('uid', int, ['optional']),
+ ],
+ },
+
+ # events methods
+ 'events': {
+ 'get': [
+ ('uid', int, ['optional']),
+ ('eids', list, ['optional']),
+ ('start_time', int, ['optional']),
+ ('end_time', int, ['optional']),
+ ('rsvp_status', str, ['optional']),
+ ],
+
+ 'getMembers': [
+ ('eid', int, []),
+ ],
+
+ 'create': [
+ ('event_info', json, []),
+ ],
+ },
+
+ # update methods
+ 'update': {
+ 'decodeIDs': [
+ ('ids', list, []),
+ ],
+ },
+
+ # groups methods
+ 'groups': {
+ 'get': [
+ ('uid', int, ['optional']),
+ ('gids', list, ['optional']),
+ ],
+
+ 'getMembers': [
+ ('gid', int, []),
+ ],
+ },
+
+ # marketplace methods
+ 'marketplace': {
+ 'createListing': [
+ ('listing_id', int, []),
+ ('show_on_profile', bool, []),
+ ('listing_attrs', str, []),
+ ],
+
+ 'getCategories': [],
+
+ 'getListings': [
+ ('listing_ids', list, []),
+ ('uids', list, []),
+ ],
+
+ 'getSubCategories': [
+ ('category', str, []),
+ ],
+
+ 'removeListing': [
+ ('listing_id', int, []),
+ ('status', str, []),
+ ],
+
+ 'search': [
+ ('category', str, ['optional']),
+ ('subcategory', str, ['optional']),
+ ('query', str, ['optional']),
+ ],
+ },
+
+ # pages methods
+ 'pages': {
+ 'getInfo': [
+ ('page_ids', list, ['optional']),
+ ('uid', int, ['optional']),
+ ],
+
+ 'isAdmin': [
+ ('page_id', int, []),
+ ],
+
+ 'isAppAdded': [
+ ('page_id', int, []),
+ ],
+
+ 'isFan': [
+ ('page_id', int, []),
+ ('uid', int, []),
+ ],
+ },
+
+ # photos methods
+ 'photos': {
+ 'addTag': [
+ ('pid', int, []),
+ ('tag_uid', int, [('default', 0)]),
+ ('tag_text', str, [('default', '')]),
+ ('x', float, [('default', 50)]),
+ ('y', float, [('default', 50)]),
+ ('tags', str, ['optional']),
+ ],
+
+ 'createAlbum': [
+ ('name', str, []),
+ ('location', str, ['optional']),
+ ('description', str, ['optional']),
+ ],
+
+ 'get': [
+ ('subj_id', int, ['optional']),
+ ('aid', int, ['optional']),
+ ('pids', list, ['optional']),
+ ],
+
+ 'getAlbums': [
+ ('uid', int, ['optional']),
+ ('aids', list, ['optional']),
+ ],
+
+ 'getTags': [
+ ('pids', list, []),
+ ],
+ },
+
+ # fbml methods
+ 'fbml': {
+ 'refreshImgSrc': [
+ ('url', str, []),
+ ],
+
+ 'refreshRefUrl': [
+ ('url', str, []),
+ ],
+
+ 'setRefHandle': [
+ ('handle', str, []),
+ ('fbml', str, []),
+ ],
+ },
+
+ # SMS Methods
+ 'sms' : {
+ 'canSend' : [
+ ('uid', int, []),
+ ],
+
+ 'send' : [
+ ('uid', int, []),
+ ('message', str, []),
+ ('session_id', int, []),
+ ('req_session', bool, []),
+ ],
+ },
+
+ 'data': {
+ 'getCookies': [
+ ('uid', int, []),
+ ('string', str, []),
+ ],
+
+ 'setCookie': [
+ ('uid', int, []),
+ ('name', str, []),
+ ('value', str, []),
+ ('expires', int, ['optional']),
+ ('path', str, ['optional']),
+ ],
+ },
+
+ # connect methods
+ 'connect': {
+ 'registerUsers': [
+ ('accounts', json, []),
+ ],
+
+ 'unregisterUsers': [
+ ('email_hashes', json, []),
+ ],
+
+ 'getUnconnectedFriendsCount': [
+ ],
+ },
+}
+
+class Proxy(object):
+ """Represents a "namespace" of Facebook API calls."""
+
+ def __init__(self, client, name):
+ self._client = client
+ self._name = name
+
+ def __call__(self, method=None, args=None, add_session_args=True):
+ # for Django templates
+ if method is None:
+ return self
+
+ if add_session_args:
+ self._client._add_session_args(args)
+
+ return self._client('%s.%s' % (self._name, method), args)
+
+
+# generate the Facebook proxies
+def __generate_proxies():
+ for namespace in METHODS:
+ methods = {}
+
+ for method in METHODS[namespace]:
+ params = ['self']
+ body = ['args = {}']
+
+ for param_name, param_type, param_options in METHODS[namespace][method]:
+ param = param_name
+
+ for option in param_options:
+ if isinstance(option, tuple) and option[0] == 'default':
+ if param_type == list:
+ param = '%s=None' % param_name
+ body.append('if %s is None: %s = %s' % (param_name, param_name, repr(option[1])))
+ else:
+ param = '%s=%s' % (param_name, repr(option[1]))
+
+ if param_type == json:
+ # we only jsonify the argument if it's a list or a dict, for compatibility
+ body.append('if isinstance(%s, list) or isinstance(%s, dict): %s = simplejson.dumps(%s)' % ((param_name,) * 4))
+
+ if 'optional' in param_options:
+ param = '%s=None' % param_name
+ body.append('if %s is not None: args[\'%s\'] = %s' % (param_name, param_name, param_name))
+ else:
+ body.append('args[\'%s\'] = %s' % (param_name, param_name))
+
+ params.append(param)
+
+ # simple docstring to refer them to Facebook API docs
+ body.insert(0, '"""Facebook API call. See http://developers.facebook.com/documentation.php?v=1.0&method=%s.%s"""' % (namespace, method))
+
+ body.insert(0, 'def %s(%s):' % (method, ', '.join(params)))
+
+ body.append('return self(\'%s\', args)' % method)
+
+ exec('\n '.join(body))
+
+ methods[method] = eval(method)
+
+ proxy = type('%sProxy' % namespace.title(), (Proxy, ), methods)
+
+ globals()[proxy.__name__] = proxy
+
+
+__generate_proxies()
+
+
+class FacebookError(Exception):
+ """Exception class for errors received from Facebook."""
+
+ def __init__(self, code, msg, args=None):
+ self.code = code
+ self.msg = msg
+ self.args = args
+
+ def __str__(self):
+ return 'Error %s: %s' % (self.code, self.msg)
+
+
+class AuthProxy(Proxy):
+ """Special proxy for facebook.auth."""
+
+ def getSession(self):
+ """Facebook API call. See http://developers.facebook.com/documentation.php?v=1.0&method=auth.getSession"""
+ args = {}
+ try:
+ args['auth_token'] = self._client.auth_token
+ except AttributeError:
+ raise RuntimeError('Client does not have auth_token set.')
+ result = self._client('%s.getSession' % self._name, args)
+ self._client.session_key = result['session_key']
+ self._client.uid = result['uid']
+ self._client.secret = result.get('secret')
+ self._client.session_key_expires = result['expires']
+ return result
+
+ def createToken(self):
+ """Facebook API call. See http://developers.facebook.com/documentation.php?v=1.0&method=auth.createToken"""
+ token = self._client('%s.createToken' % self._name)
+ self._client.auth_token = token
+ return token
+
+
+class FriendsProxy(FriendsProxy):
+ """Special proxy for facebook.friends."""
+
+ def get(self, **kwargs):
+ """Facebook API call. See http://developers.facebook.com/documentation.php?v=1.0&method=friends.get"""
+ if not kwargs.get('flid') and self._client._friends:
+ return self._client._friends
+ return super(FriendsProxy, self).get(**kwargs)
+
+
+class PhotosProxy(PhotosProxy):
+ """Special proxy for facebook.photos."""
+
+ def upload(self, image, aid=None, caption=None, size=(604, 1024), filename=None):
+ """Facebook API call. See http://developers.facebook.com/documentation.php?v=1.0&method=photos.upload
+
+ size -- an optional size (width, height) to resize the image to before uploading. Resizes by default
+ to Facebook's maximum display width of 604.
+ """
+ args = {}
+
+ if aid is not None:
+ args['aid'] = aid
+
+ if caption is not None:
+ args['caption'] = caption
+
+ args = self._client._build_post_args('facebook.photos.upload', self._client._add_session_args(args))
+
+ try:
+ import cStringIO as StringIO
+ except ImportError:
+ import StringIO
+
+ # check for a filename specified...if the user is passing binary data in
+ # image then a filename will be specified
+ if filename is None:
+ try:
+ import Image
+ except ImportError:
+ data = StringIO.StringIO(open(image, 'rb').read())
+ else:
+ img = Image.open(image)
+ if size:
+ img.thumbnail(size, Image.ANTIALIAS)
+ data = StringIO.StringIO()
+ img.save(data, img.format)
+ else:
+ # there was a filename specified, which indicates that image was not
+ # the path to an image file but rather the binary data of a file
+ data = StringIO.StringIO(image)
+ image = filename
+
+ content_type, body = self.__encode_multipart_formdata(list(args.iteritems()), [(image, data)])
+ urlinfo = urlparse.urlsplit(self._client.facebook_url)
+ try:
+ h = httplib.HTTP(urlinfo[1])
+ h.putrequest('POST', urlinfo[2])
+ h.putheader('Content-Type', content_type)
+ h.putheader('Content-Length', str(len(body)))
+ h.putheader('MIME-Version', '1.0')
+ h.putheader('User-Agent', 'PyFacebook Client Library')
+ h.endheaders()
+ h.send(body)
+
+ reply = h.getreply()
+
+ if reply[0] != 200:
+ raise Exception('Error uploading photo: Facebook returned HTTP %s (%s)' % (reply[0], reply[1]))
+
+ response = h.file.read()
+ except:
+ # sending the photo failed, perhaps we are using GAE
+ try:
+ from google.appengine.api import urlfetch
+
+ try:
+ response = urlread(url=self._client.facebook_url,data=body,headers={'POST':urlinfo[2],'Content-Type':content_type,'MIME-Version':'1.0'})
+ except urllib2.URLError:
+ raise Exception('Error uploading photo: Facebook returned %s' % (response))
+ except ImportError:
+ # could not import from google.appengine.api, so we are not running in GAE
+ raise Exception('Error uploading photo.')
+
+ return self._client._parse_response(response, 'facebook.photos.upload')
+
+
+ def __encode_multipart_formdata(self, fields, files):
+ """Encodes a multipart/form-data message to upload an image."""
+ boundary = '-------tHISiStheMulTIFoRMbOUNDaRY'
+ crlf = '\r\n'
+ l = []
+
+ for (key, value) in fields:
+ l.append('--' + boundary)
+ l.append('Content-Disposition: form-data; name="%s"' % str(key))
+ l.append('')
+ l.append(str(value))
+ for (filename, value) in files:
+ l.append('--' + boundary)
+ l.append('Content-Disposition: form-data; filename="%s"' % (str(filename), ))
+ l.append('Content-Type: %s' % self.__get_content_type(filename))
+ l.append('')
+ l.append(value.getvalue())
+ l.append('--' + boundary + '--')
+ l.append('')
+ body = crlf.join(l)
+ content_type = 'multipart/form-data; boundary=%s' % boundary
+ return content_type, body
+
+
+ def __get_content_type(self, filename):
+ """Returns a guess at the MIME type of the file from the filename."""
+ return str(mimetypes.guess_type(filename)[0]) or 'application/octet-stream'
+
+
+class Facebook(object):
+ """
+ Provides access to the Facebook API.
+
+ Instance Variables:
+
+ added
+ True if the user has added this application.
+
+ api_key
+ Your API key, as set in the constructor.
+
+ app_name
+ Your application's name, i.e. the APP_NAME in http://apps.facebook.com/APP_NAME/ if
+ this is for an internal web application. Optional, but useful for automatic redirects
+ to canvas pages.
+
+ auth_token
+ The auth token that Facebook gives you, either with facebook.auth.createToken,
+ or through a GET parameter.
+
+ callback_path
+ The path of the callback set in the Facebook app settings. If your callback is set
+ to http://www.example.com/facebook/callback/, this should be '/facebook/callback/'.
+ Optional, but useful for automatic redirects back to the same page after login.
+
+ desktop
+ True if this is a desktop app, False otherwise. Used for determining how to
+ authenticate.
+
+ facebook_url
+ The url to use for Facebook requests.
+
+ facebook_secure_url
+ The url to use for secure Facebook requests.
+
+ in_canvas
+ True if the current request is for a canvas page.
+
+ internal
+ True if this Facebook object is for an internal application (one that can be added on Facebook)
+
+ page_id
+ Set to the page_id of the current page (if any)
+
+ secret
+ Secret that is used after getSession for desktop apps.
+
+ secret_key
+ Your application's secret key, as set in the constructor.
+
+ session_key
+ The current session key. Set automatically by auth.getSession, but can be set
+ manually for doing infinite sessions.
+
+ session_key_expires
+ The UNIX time of when this session key expires, or 0 if it never expires.
+
+ uid
+ After a session is created, you can get the user's UID with this variable. Set
+ automatically by auth.getSession.
+
+ ----------------------------------------------------------------------
+
+ """
+
+ def __init__(self, api_key, secret_key, auth_token=None, app_name=None, callback_path=None, internal=None, proxy=None, facebook_url=None, facebook_secure_url=None):
+ """
+ Initializes a new Facebook object which provides wrappers for the Facebook API.
+
+ If this is a desktop application, the next couple of steps you might want to take are:
+
+ facebook.auth.createToken() # create an auth token
+ facebook.login() # show a browser window
+ wait_login() # somehow wait for the user to log in
+ facebook.auth.getSession() # get a session key
+
+ For web apps, if you are passed an auth_token from Facebook, pass that in as a named parameter.
+ Then call:
+
+ facebook.auth.getSession()
+
+ """
+ self.api_key = api_key
+ self.secret_key = secret_key
+ self.session_key = None
+ self.session_key_expires = None
+ self.auth_token = auth_token
+ self.secret = None
+ self.uid = None
+ self.page_id = None
+ self.in_canvas = False
+ self.added = False
+ self.app_name = app_name
+ self.callback_path = callback_path
+ self.internal = internal
+ self._friends = None
+ self.proxy = proxy
+ if facebook_url is None:
+ self.facebook_url = FACEBOOK_URL
+ else:
+ self.facebook_url = facebook_url
+ if facebook_secure_url is None:
+ self.facebook_secure_url = FACEBOOK_SECURE_URL
+ else:
+ self.facebook_secure_url = facebook_secure_url
+
+ for namespace in METHODS:
+ self.__dict__[namespace] = eval('%sProxy(self, \'%s\')' % (namespace.title(), 'facebook.%s' % namespace))
+
+ self.auth = AuthProxy(self, 'facebook.auth')
+
+
+ def _hash_args(self, args, secret=None):
+ """Hashes arguments by joining key=value pairs, appending a secret, and then taking the MD5 hex digest."""
+ # @author: houyr
+ # fix for UnicodeEncodeError
+ hasher = md5.new(''.join(['%s=%s' % (isinstance(x, unicode) and x.encode("utf-8") or x, isinstance(args[x], unicode) and args[x].encode("utf-8") or args[x]) for x in sorted(args.keys())]))
+ if secret:
+ hasher.update(secret)
+ elif self.secret:
+ hasher.update(self.secret)
+ else:
+ hasher.update(self.secret_key)
+ return hasher.hexdigest()
+
+
+ def _parse_response_item(self, node):
+ """Parses an XML response node from Facebook."""
+ if node.nodeType == node.DOCUMENT_NODE and \
+ node.childNodes[0].hasAttributes() and \
+ node.childNodes[0].hasAttribute('list') and \
+ node.childNodes[0].getAttribute('list') == "true":
+ return {node.childNodes[0].nodeName: self._parse_response_list(node.childNodes[0])}
+ elif node.nodeType == node.ELEMENT_NODE and \
+ node.hasAttributes() and \
+ node.hasAttribute('list') and \
+ node.getAttribute('list')=="true":
+ return self._parse_response_list(node)
+ elif len(filter(lambda x: x.nodeType == x.ELEMENT_NODE, node.childNodes)) > 0:
+ return self._parse_response_dict(node)
+ else:
+ return ''.join(node.data for node in node.childNodes if node.nodeType == node.TEXT_NODE)
+
+
+ def _parse_response_dict(self, node):
+ """Parses an XML dictionary response node from Facebook."""
+ result = {}
+ for item in filter(lambda x: x.nodeType == x.ELEMENT_NODE, node.childNodes):
+ result[item.nodeName] = self._parse_response_item(item)
+ if node.nodeType == node.ELEMENT_NODE and node.hasAttributes():
+ if node.hasAttribute('id'):
+ result['id'] = node.getAttribute('id')
+ return result
+
+
+ def _parse_response_list(self, node):
+ """Parses an XML list response node from Facebook."""
+ result = []
+ for item in filter(lambda x: x.nodeType == x.ELEMENT_NODE, node.childNodes):
+ result.append(self._parse_response_item(item))
+ return result
+
+
+ def _check_error(self, response):
+ """Checks if the given Facebook response is an error, and then raises the appropriate exception."""
+ if type(response) is dict and response.has_key('error_code'):
+ raise FacebookError(response['error_code'], response['error_msg'], response['request_args'])
+
+
+ def _build_post_args(self, method, args=None):
+ """Adds to args parameters that are necessary for every call to the API."""
+ if args is None:
+ args = {}
+
+ for arg in args.items():
+ if type(arg[1]) == list:
+ args[arg[0]] = ','.join(str(a) for a in arg[1])
+ elif type(arg[1]) == unicode:
+ args[arg[0]] = arg[1].encode("UTF-8")
+ elif type(arg[1]) == bool:
+ args[arg[0]] = str(arg[1]).lower()
+
+ args['method'] = method
+ args['api_key'] = self.api_key
+ args['v'] = '1.0'
+ args['format'] = RESPONSE_FORMAT
+ args['sig'] = self._hash_args(args)
+
+ return args
+
+
+ def _add_session_args(self, args=None):
+ """Adds 'session_key' and 'call_id' to args, which are used for API calls that need sessions."""
+ if args is None:
+ args = {}
+
+ if not self.session_key:
+ return args
+ #some calls don't need a session anymore. this might be better done in the markup
+ #raise RuntimeError('Session key not set. Make sure auth.getSession has been called.')
+
+ args['session_key'] = self.session_key
+ args['call_id'] = str(int(time.time() * 1000))
+
+ return args
+
+
+ def _parse_response(self, response, method, format=None):
+ """Parses the response according to the given (optional) format, which should be either 'JSON' or 'XML'."""
+ if not format:
+ format = RESPONSE_FORMAT
+
+ if format == 'JSON':
+ result = simplejson.loads(response)
+
+ self._check_error(result)
+ elif format == 'XML':
+ dom = minidom.parseString(response)
+ result = self._parse_response_item(dom)
+ dom.unlink()
+
+ if 'error_response' in result:
+ self._check_error(result['error_response'])
+
+ result = result[method[9:].replace('.', '_') + '_response']
+ else:
+ raise RuntimeError('Invalid format specified.')
+
+ return result
+
+
+ def hash_email(self, email):
+ """
+ Hash an email address in a format suitable for Facebook Connect.
+
+ """
+ email = email.lower().strip()
+ return "%s_%s" % (
+ struct.unpack("I", struct.pack("i", binascii.crc32(email)))[0],
+ hashlib.md5(email).hexdigest(),
+ )
+
+
+ def unicode_urlencode(self, params):
+ """
+ @author: houyr
+ A unicode aware version of urllib.urlencode.
+ """
+ if isinstance(params, dict):
+ params = params.items()
+ return urllib.urlencode([(k, isinstance(v, unicode) and v.encode('utf-8') or v)
+ for k, v in params])
+
+
+ def __call__(self, method=None, args=None, secure=False):
+ """Make a call to Facebook's REST server."""
+ # for Django templates, if this object is called without any arguments
+ # return the object itself
+ if method is None:
+ return self
+
+ # @author: houyr
+ # fix for bug of UnicodeEncodeError
+ post_data = self.unicode_urlencode(self._build_post_args(method, args))
+ print post_data
+
+ if self.proxy:
+ proxy_handler = urllib2.ProxyHandler(self.proxy)
+ opener = urllib2.build_opener(proxy_handler)
+ if secure:
+ response = opener.open(self.facebook_secure_url, post_data).read()
+ else:
+ response = opener.open(self.facebook_url, post_data).read()
+ else:
+ if secure:
+ response = urlread(self.facebook_secure_url, post_data)
+ else:
+ response = urlread(self.facebook_url, post_data)
+
+ print response
+ return self._parse_response(response, method)
+
+
+ # URL helpers
+ def get_url(self, page, **args):
+ """
+ Returns one of the Facebook URLs (www.facebook.com/SOMEPAGE.php).
+ Named arguments are passed as GET query string parameters.
+
+ """
+ print 'page, args:', page, args
+ return 'http://www.facebook.com/%s.php?%s' % (page, urllib.urlencode(args))
+
+
+ def get_app_url(self, path=''):
+ """
+ Returns the URL for this app's canvas page, according to app_name.
+
+ """
+ return 'http://apps.facebook.com/%s/%s' % (self.app_name, path)
+
+
+ def get_add_url(self, next=None):
+ """
+ Returns the URL that the user should be redirected to in order to add the application.
+
+ """
+ args = {'api_key': self.api_key, 'v': '1.0'}
+
+ if next is not None:
+ args['next'] = next
+
+ return self.get_url('install', **args)
+
+
+ def get_authorize_url(self, next=None, next_cancel=None):
+ """
+ Returns the URL that the user should be redirected to in order to
+ authorize certain actions for application.
+
+ """
+ args = {'api_key': self.api_key, 'v': '1.0'}
+
+ if next is not None:
+ args['next'] = next
+
+ if next_cancel is not None:
+ args['next_cancel'] = next_cancel
+
+ return self.get_url('authorize', **args)
+
+
+ def get_login_url(self, next=None, popup=False, canvas=False):
+ """
+ Returns the URL that the user should be redirected to in order to login.
+
+ next -- the URL that Facebook should redirect to after login
+
+ """
+ args = {'api_key': self.api_key, 'v': '1.0'}
+
+ if next is not None:
+ args['next'] = next
+
+ if canvas is True:
+ args['canvas'] = 1
+
+ if popup is True:
+ args['popup'] = 1
+
+ if self.auth_token is not None:
+ args['auth_token'] = self.auth_token
+
+ return self.get_url('login', **args)
+
+
+ def login(self, popup=False):
+ """Open a web browser telling the user to login to Facebook."""
+ import webbrowser
+ webbrowser.open(self.get_login_url(popup=popup))
+
+
+ def get_ext_perm_url(self, ext_perm, next=None, popup=False):
+ """
+ Returns the URL that the user should be redirected to in order to grant an extended permission.
+
+ ext_perm -- the name of the extended permission to request
+ next -- the URL that Facebook should redirect to after login
+
+ """
+ args = {'ext_perm': ext_perm, 'api_key': self.api_key, 'v': '1.0'}
+
+ if next is not None:
+ args['next'] = next
+
+ if popup is True:
+ args['popup'] = 1
+
+ return self.get_url('authorize', **args)
+
+
+ def request_extended_permission(self, ext_perm, popup=False):
+ """Open a web browser telling the user to grant an extended permission."""
+ import webbrowser
+ webbrowser.open(self.get_ext_perm_url(ext_perm, popup=popup))
+
+
+ def check_session(self, request):
+ """
+ Checks the given Django HttpRequest for Facebook parameters such as
+ POST variables or an auth token. If the session is valid, returns True
+ and this object can now be used to access the Facebook API. Otherwise,
+ it returns False, and the application should take the appropriate action
+ (either log the user in or have him add the application).
+
+ """
+ self.in_canvas = (request.POST.get('fb_sig_in_canvas') == '1')
+
+ if self.session_key and (self.uid or self.page_id):
+ return True
+
+ if request.method == 'POST':
+ params = self.validate_signature(request.POST)
+ else:
+ if 'installed' in request.GET:
+ self.added = True
+
+ if 'fb_page_id' in request.GET:
+ self.page_id = request.GET['fb_page_id']
+
+ if 'auth_token' in request.GET:
+ self.auth_token = request.GET['auth_token']
+
+ try:
+ self.auth.getSession()
+ except FacebookError, e:
+ self.auth_token = None
+ return False
+
+ return True
+
+ params = self.validate_signature(request.GET)
+
+ if not params:
+ # first check if we are in django - to check cookies
+ if hasattr(request, 'COOKIES'):
+ params = self.validate_cookie_signature(request.COOKIES)
+ else:
+ # if not, then we might be on GoogleAppEngine, check their request object cookies
+ if hasattr(request,'cookies'):
+ params = self.validate_cookie_signature(request.cookies)
+
+ if not params:
+ return False
+
+ if params.get('in_canvas') == '1':
+ self.in_canvas = True
+
+ if params.get('added') == '1':
+ self.added = True
+
+ if params.get('expires'):
+ self.session_key_expires = int(params['expires'])
+
+ if 'friends' in params:
+ if params['friends']:
+ self._friends = params['friends'].split(',')
+ else:
+ self._friends = []
+
+ if 'session_key' in params:
+ self.session_key = params['session_key']
+ if 'user' in params:
+ self.uid = params['user']
+ elif 'page_id' in params:
+ self.page_id = params['page_id']
+ else:
+ return False
+ elif 'profile_session_key' in params:
+ self.session_key = params['profile_session_key']
+ if 'profile_user' in params:
+ self.uid = params['profile_user']
+ else:
+ return False
+ else:
+ return False
+
+ return True
+
+
+ def validate_signature(self, post, prefix='fb_sig', timeout=None):
+ """
+ Validate parameters passed to an internal Facebook app from Facebook.
+
+ """
+ args = post.copy()
+
+ if prefix not in args:
+ return None
+
+ del args[prefix]
+
+ if timeout and '%s_time' % prefix in post and time.time() - float(post['%s_time' % prefix]) > timeout:
+ return None
+
+ args = dict([(key[len(prefix + '_'):], value) for key, value in args.items() if key.startswith(prefix)])
+
+ hash = self._hash_args(args)
+
+ if hash == post[prefix]:
+ return args
+ else:
+ return None
+
+ def validate_cookie_signature(self, cookies):
+ """
+ Validate parameters passed by cookies, namely facebookconnect or js api.
+ """
+ if not self.api_key in cookies.keys():
+ return None
+
+ sigkeys = []
+ params = dict()
+ for k in sorted(cookies.keys()):
+ if k.startswith(self.api_key+"_"):
+ sigkeys.append(k)
+ params[k.replace(self.api_key+"_","")] = cookies[k]
+
+
+ vals = ''.join(['%s=%s' % (x.replace(self.api_key+"_",""), cookies[x]) for x in sigkeys])
+ hasher = md5.new(vals)
+
+ hasher.update(self.secret_key)
+ digest = hasher.hexdigest()
+ if digest == cookies[self.api_key]:
+ return params
+ else:
+ return False
+
+
+
+
+if __name__ == '__main__':
+ # sample desktop application
+
+ api_key = ''
+ secret_key = ''
+
+ facebook = Facebook(api_key, secret_key)
+
+ facebook.auth.createToken()
+
+ # Show login window
+ # Set popup=True if you want login without navigational elements
+ facebook.login()
+
+ # Login to the window, then press enter
+ print 'After logging in, press enter...'
+ raw_input()
+
+ facebook.auth.getSession()
+ print 'Session Key: ', facebook.session_key
+ print 'Your UID: ', facebook.uid
+
+ info = facebook.users.getInfo([facebook.uid], ['name', 'birthday', 'affiliations', 'sex'])[0]
+
+ print 'Your Name: ', info['name']
+ print 'Your Birthday: ', info['birthday']
+ print 'Your Gender: ', info['sex']
+
+ friends = facebook.friends.get()
+ friends = facebook.users.getInfo(friends[0:5], ['name', 'birthday', 'relationship_status'])
+
+ for friend in friends:
+ print friend['name'], 'has a birthday on', friend['birthday'], 'and is', friend['relationship_status']
+
+ arefriends = facebook.friends.areFriends([friends[0]['uid']], [friends[1]['uid']])
+
+ photos = facebook.photos.getAlbums(facebook.uid)