Gc @sdZdZddkZddkZddkZyddklZWnIej o=yddkZWn#ej oddk lZnXnXddk Z ddk Z ddk Z dZ dZdZd efd YZd efd YZd efdYZdefdYZdefdYZdefdYZdefdYZde iifdYZdefdYZdS(s GDataService provides CRUD ops. and programmatic login for GData services. Error: A base exception class for all exceptions in the gdata_client module. CaptchaRequired: This exception is thrown when a login attempt results in a captcha challenge from the ClientLogin service. When this exception is thrown, the captcha_token and captcha_url are set to the values provided in the server's response. BadAuthentication: Raised when a login attempt is made with an incorrect username or password. NotAuthenticated: Raised if an operation requiring authentication is called before a user has authenticated. NonAuthSubToken: Raised if a method to modify an AuthSub token is used when the user is either not authenticated or is authenticated through programmatic login. RequestError: Raised if a CRUD request returned a non-success code. UnexpectedReturnType: Raised if the response from the server was not of the desired type. For example, this would be raised if the server sent a feed when the client requested an entry. GDataService: Encapsulates user credentials needed to perform insert, update and delete operations with the GData API. An instance can perform user authentication, query, insertion, deletion, and update. Query: Eases query URI creation by allowing URI parameters to be set as dictionary attributes. For example a query with a feed of '/base/feeds/snippets' and ['bq'] set to 'digital camera' will produce '/base/feeds/snippets?bq=digital+camera' when .ToUri() is called on it. sapi.jscudder (Jeffrey Scudder)iN(t cElementTree(t ElementTreesGoogleLogin auths AuthSub tokenshttps://www.google.com/tErrorcBseZRS((t__name__t __module__(((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyROstCaptchaRequiredcBseZRS((RR(((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyRSstBadAuthenticationcBseZRS((RR(((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyRWstNotAuthenticatedcBseZRS((RR(((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyR[stNonAuthSubTokencBseZRS((RR(((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyR_st RequestErrorcBseZRS((RR(((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyR cstUnexpectedReturnTypecBseZRS((RR(((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyR gst GDataServicecBseZdZd%d%dd%d%d%d%dZdZdZdZdZe eeddZ d Z d Z e e dd Z d Zd Ze eddZdZdZdZdZdZdZe eeddZd%d%dZd%d%d%d%d%dZeedZdZdZd%ddd%dZd%dZ d%dZ!d%d Z"d%d%edd%d%d!Z#d%d%ed"d%d%d#Z$d%d%edd$Z%RS(&sContains elements needed for GData login and CRUD request headers. Maintains additional headers (tokens for example) needed for the GData services to allow a user to perform inserts, updates, and deletes. tHOSTED_OR_GOOGLEcCs{||_||_||_||_||_|ph|_|i|d|_d|_ d|_ d|_ d|_ dS(sCreates an object of type GDataService. Args: email: string (optional) The user's email address, used for authentication. password: string (optional) The user's password. account_type: string (optional) The type of account to use. Use 'GOOGLE' for regular Google accounts or 'HOSTED' for Google Apps accounts, or 'HOSTED_OR_GOOGLE' to try finding a HOSTED account first and, if it doesn't exist, try finding a regular GOOGLE account. Default value: 'HOSTED_OR_GOOGLE'. service: string (optional) The desired service for which credentials will be obtained. source: string (optional) The name of the user's application. server: string (optional) The name of the server to which a connection will be opened. Default value: 'base.google.com'. additional_headers: dictionary (optional) Any additional headers which should be included with CRUD operations. N( temailtpasswordt account_typetservicetservertadditional_headerst_GDataService__SetSourcetNonet_GDataService__auth_tokent_GDataService__auth_typet_GDataService__captcha_tokent_GDataService__captcha_urlt_GDataService__gsessionid(tselfR RRRtsourceRR((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyt__init__rs          cCs||_t|_dS(sSets the token sent in requests to an AuthSub token. Only use this method if you have received a token from the AuthSub service. The auth_token is set automatically when ProgrammaticLogin() is used. See documentation for Google AuthSub here: http://code.google.com/apis/accounts/AuthForWebApps.html . Args: auth_token: string The token returned by the AuthSub service. N(RtAUTHSUB_AUTH_LABELR(Rt auth_token((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyt_SetAuthSubTokens cCs|i|dS(N(R(RR((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyt__SetAuthSubTokenscCs|iS(sXReturns the auth token used for authenticating requests. Returns: string (R(R((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyt _GetAuthTokenscCs |iS(N(R!(R((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyt__GetAuthTokenstdocs-Get or set the token used for authentication.cCs|iS(sReturns a captcha token if the most recent login attempt generated one. The captcha token is only set if the Programmatic Login attempt failed because the Google service issued a captcha challenge. Returns: string (R(R((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyt_GetCaptchaTokens cCs |iS(N(R$(R((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyt__GetCaptchaTokenss*Get the captcha token for a login request.cCs|iS(sReturns the URL of the captcha image if a login attempt generated one. The captcha URL is only set if the Programmatic Login attempt failed because the Google service issued a captcha challenge. Returns: string (R(R((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyt_GetCaptchaURLs cCs |iS(N(R&(R((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyt__GetCaptchaURLss(Get the captcha URL for a login request.cCs#|itjo |iSndSdS(N(RRRR(R((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pytGetAuthSubTokens cCs||_t|_dS(N(RRR(Rttoken((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pytSetAuthSubTokens cCs#|itjo |iSndSdS(N(RtPROGRAMMATIC_AUTH_LABELRR(R((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pytGetClientLoginTokens cCs||_t|_dS(N(RR+R(RR)((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pytSetClientLoginTokens cCs|iS(N(t_GDataService__source(R((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyt __GetSourcescCs!||_d|i|id|i D],}|i do|id|_qqWnd S( sUpgrades a single use AuthSub token to a session token. Raises: NonAuthSubToken if the user's auth token is not an AuthSub token tGETs/accounts/AuthSubSessionTokens Content-Types!application/x-www-form-urlencodedt Authorizations%s=%sisToken=N(RRRR:R;R<R=RR@RBRDRCRERFRG(Rtupgrade_connectionRLtresponseRNRO((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pytUpgradeToSessionTokens"       cCs|itjo tn|it\}}|idd|idd|idd|i|if|i|i }|i djod|_d|_ndS( s{Revokes an existing AuthSub token. Raises: NonAuthSubToken if the user's auth token is not an AuthSub token RZs/accounts/AuthSubRevokeTokens Content-Types!application/x-www-form-urlencodedR[s%s=%siN( RRRR:R;R<R=RR@RBRCR(Rtrevoke_connectionRLR]((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pytRevokeAuthSubTokens      isUTF-8c Cs^|djo h}n|iod|i|if|dtappendt content_typeR?tcontent_lengthRhRRiR{RAt file_handleRDRBtPostRCRkRlRmRnRoRpRqRrR Re(RtdataRLRst url_paramst escape_paramsRtt media_sourceRdtdata_strt multiparttinsert_connectiont binarydataRuRvt http_dataRRwRxRyRz((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyRis"         D             ic  Cs|d$jo h}n|iod|i|if|dRRR?RRhRRiR{RARRDRBtPutRCRkRlRmRnRoRpRqRrR Re(RRRLRsRRRtRRdRRRRRuRvRRRwRxRyRz((sA/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/service.pyRs         D            c Cs |djo h}n|iod|i|if|d6s:      Y