Ñò äÒÔPc@s€dZddkZddkZddkZddkZddkZddkZddkZddkZddk Z ddk Z yddk Z WnIe j o=yddkl Z Wne j oddk Z nXnXe iZyddklZWn#e j oddklZnXdefd„ƒYZdefd„ƒYZd „Zd „Zeed „Zd „Zd „ZdS(sÌPython client library for the Facebook Platform. This client library is designed to support the Graph API and the official Facebook JavaScript SDK, which is the canonical way to implement Facebook authentication. Read more about the Graph API at http://developers.facebook.com/docs/api. You can download the Facebook JavaScript SDK at http://github.com/facebook/connect-js/. If your application is using Google AppEngine's webapp framework, your usage of this module might look like this: user = facebook.get_user_from_cookie(self.request.cookies, key, secret) if user: graph = facebook.GraphAPI(user["access_token"]) profile = graph.get_object("me") friends = graph.get_connections("me", "friends") iÿÿÿÿN(t simplejson(tparse_qstGraphAPIcBs³eZdZddd„Zd„Zd„Zd„Zd„Zhdd„Z d„Z d „Z d „Z d „Z ddd „Zd „Zddd„Zddd„Zd„ZRS(sŒA client for the Facebook Graph API. See http://developers.facebook.com/docs/api for complete documentation for the API. The Graph API is made up of the objects in Facebook (e.g., people, pages, events, photos) and the connections between them (e.g., friends, photo tags, and event RSVPs). This client provides access to those primitive types in a generic way. For example, given an OAuth access token, this will fetch the profile of the active user and the list of the user's friends: graph = facebook.GraphAPI(access_token) user = graph.get_object("me") friends = graph.get_connections(user["id"], "friends") You can see a list of all of the objects and connections supported by the API at http://developers.facebook.com/docs/reference/api/. You can obtain an access token via OAuth or by using the Facebook JavaScript SDK. See http://developers.facebook.com/docs/authentication/ for details. If you are using the JavaScript SDK, you can use the get_user_from_cookie() method below to get the OAuth access token for the active user from the cookie saved by the SDK. cCs||_||_dS(N(t access_tokenttimeout(tselfRR((s facebook.pyt__init__]s cKs|i||ƒS(s'Fetchs the given object from the graph.(trequest(Rtidtargs((s facebook.pyt get_objectascKs#di|ƒ|d<|id|ƒS(s¡Fetchs all of the given object from the graph. We return a map from ID to object. If any of the IDs are invalid, we raise an exception. t,tidst(tjoinR(RR R ((s facebook.pyt get_objectsescKs|i|d||ƒS(s(Fetchs the connections for given object.t/(R(RRtconnection_nameR ((s facebook.pytget_connectionsnscKs/|ip td‚|i|d|d|ƒS(s]Writes the given object to the graph, connected to the given parent. For example, graph.put_object("me", "feed", message="Hello, world") writes "Hello, world" to the active user's wall. Likewise, this will comment on a the first post of the active user's feed: feed = graph.get_connections("me", "feed") post = feed["data"][0] graph.put_object(post["id"], "comments", message="First!") See http://developers.facebook.com/docs/api#publishing for all of the supported writeable objects. Certain write operations require extended permissions. For example, publishing to a user's feed requires the "publish_actions" permission. See http://developers.facebook.com/docs/publishing/ for details about publishing permissions. s(Write operations require an access tokenRt post_args(RtAssertionErrorR(Rt parent_objectRtdata((s facebook.pyt put_objectrstmecCs|i|dd||S(sIWrites a wall post to the given profile's wall. We default to writing to the authenticated user's wall if no profile_id is specified. attachment adds a structured attachment to the status message being posted to the Wall. It should be a dictionary of the form: {"name": "Link name" "link": "http://www.example.com/", "caption": "{*actor*} posted a new review", "description": "This is a longer description of the attachment", "picture": "http://www.example.com/thumbnail.jpg"} tfeedtmessage(R(RRt attachmentt profile_id((s facebook.pyt put_wall_postŽscCs|i|dd|ƒS(s+Writes the given comment on the given post.tcommentsR(R(Rt object_idR((s facebook.pyt put_comment¡scCs|i|dƒS(sLikes the given post.tlikes(R(RR((s facebook.pytput_like¥scCs|i|dhdd6ƒdS(s4Deletes the object with the given ID from the graph.RtdeletetmethodN(R(RR((s facebook.pyt delete_object©scCs®tidƒ}d||tih|id6ƒf}|id|ƒ|iƒ}|iƒ}t|ƒ}|o0t |t ƒo |i dƒot |ƒ‚n|i ƒdS(s9Deletes the Request with the given ID for the given user.sgraph.facebook.coms /%s_%s?%sRtDELETEterrorN(thttplibtHTTPSConnectionturllibt urlencodeRRt getresponsetreadt _parse_jsont isinstancetdicttgett GraphAPIErrortclose(Rtuser_idt request_idtconnturltresponseR((s facebook.pytdelete_request­s   'c Ks|pd}h|id6|d6|d6}|i|ƒ|i|ƒ\}}tid|d|ƒ} | id|ƒyti| ƒiƒ} Wn$tij o} | iƒ} nXyGt | ƒ} | o0t | t ƒo | i dƒot | ƒ‚nWntj o | } nX| S( súUploads an image using multipart/form-data. image=File like object for the image message=Caption for your image album_id=None posts to /me/photos which uses or creates and uses an album for your application. RRtsourceRs$https://graph.facebook.com/%s/photosRs Content-TypeR'(Rtupdatet_encode_multipart_formturllib2tRequestt add_headerturlopenR-t HTTPErrorR.R/R0R1R2t ValueError( RtimageRtalbum_idtkwargsRRt content_typetbodytreqRteR8((s facebook.pyt put_photoÂs.        c Cs‹d}d}g}x1|iƒD]#\}}tid|t|ƒ|fƒ|pqn|id|ƒt|dƒomt|iƒo]t|dd|ƒ}|id||fƒ|id ƒ|iƒ}tit|ƒƒn|id |ƒ|id ƒt |t ƒo tid ƒ|i d ƒ}n|i|ƒqW|id|dƒ|id ƒ|i |ƒ}d|} | |fS(s%Encode files as 'multipart/form-data'. Fields are a dict of form name-> value. For files, value should be a file object. Other file-like objects might work and a fake name will be chosen. Returns (content_type, body) ready for httplib.HTTP instance. s ----------ThIs_Is_tHe_bouNdaRY_$s sEncoding %s, (%s)%ss--R-tnames%s.jpgs6Content-Disposition: form-data;name="%s";filename="%s"sContent-Type: image/jpegs)Content-Disposition: form-data; name="%s"R sConvert to asciitasciis multipart/form-data; boundary=%s( titemstloggingtdebugttypetappendthasattrtcallableR-tgetattrR/tunicodetencodeR( RtfieldstBOUNDARYtCRLFtLtkeytvaluetfilenameRGRF((s facebook.pyR<ís6           c Cs |ph}|io/|d j o|i|d t client_idt client_secrettfb_exchange_tokent grant_types.https://graph.facebook.com/oauth/access_token?RitexpiresN( RR*R@R+R-RRmtloadsR2(Rtapp_idt app_secretR R8t query_strtresult((s facebook.pytextend_access_tokenys     N(t__name__t __module__t__doc__R`RR RRRRR R"R%R9RJR<RRtR(((s facebook.pyR@s        + '14R2cBseZd„ZRS(c Cs¢||_y|d|_Wnd|_nXy|d|_WnJy|dd|_Wq‹y|d|_Wq‡||_q‡Xq‹XnXti||iƒdS(NRoR terror_descriptionR'Rt error_msg(R~RPRRqR(RR~((s facebook.pyR•s   (R€RR(((s facebook.pyR2”scCsƒ|id|dƒ}|pdSt||ƒ}|pdSyt|dd||ƒ}Wntj odSX|d|d<|S(s„Parses the cookie set by the official Facebook JavaScript SDK. cookies should be a dictionary-like object mapping cookie names to cookie values. If the user is logged in via Facebook, we return a dictionary with the keys "uid" and "access_token". The former is the user's Facebook ID, and the latter can be used to make authenticated requests to the Graph API. If the user is not logged in, we return None. Download the official Facebook JavaScript SDK at http://github.com/facebook/connect-js/. Read more about Facebook authentication at http://developers.facebook.com/docs/authentication/. tfbsr_R tcodeR4tuidN(R1R`tparse_signed_requesttget_access_token_from_codeR2(tcookiesR{R|tcookietparsed_requestR~((s facebook.pytget_user_from_cookie¯s c Cs:yˆ|iddƒ}t|dƒ}t|dƒ}ti|ddt|ƒddƒ}ti|ddt|ƒddƒ}Wn'tj otStj otSXt|ƒ}|i ddƒi ƒd jotS|i d ƒ}|i d ƒ}t i |d |d tiƒiƒ}||jotS|S( s< Return dictionary with signed request data. We return a dictionary containing the information in the signed_request. This includes a user_id if the user has authorised your application, as well as any information requested. If the signed_request is malformed or corrupted, False is returned. t.iiit=it algorithmR s HMAC-SHA256RLtmsgt digestmod(tsplittstrtbase64turlsafe_b64decodetlent IndexErrortFalseRaR.R1tupperRVthmactnewthashlibtsha256tdigest(tsigned_requestR|tlt encoded_sigtpayloadtsigRt expected_sig((s facebook.pyRˆÐs.   !   cCs^d}h|d6|d6}|odi|ƒ|d"s<           ÿU ! +