|Gc @sdZdZddkZyddklZWnIej o=yddkZWqxej oddklZqxXnXddkZdZ dZ dZ d Z d Z d Zd Zd ZdZdZdZdefdYZdefdYZdefdYZdeifdYZdeifdYZdZdeifdYZdZdeifd YZd!Z d"ei!efd#YZ"d$Z#d%ei$efd&YZ%d'Z&d(eifd)YZ'd*Z(d+eifd,YZ)d-Z*d.eifd/YZ+d0Z,d1e"fd2YZ-d3Z.d4eifd5YZ/d6Z0d7e%fd8YZ1d9Z2d:eifd;YZ3d<Z4d=eifd>YZ5d?Z6dS(@srContains classes representing Google Data elements. Extends Atom classes to add Google Data specific elements. sapi.jscudder (Jeffrey Scudder)iN(t cElementTree(t ElementTrees http://schemas.google.com/g/2005s${http://schemas.google.com/g/2005}%ss'http://a9.com/-/spec/opensearchrss/1.0/s+{http://a9.com/-/spec/opensearchrss/1.0/}%ss%http://schemas.google.com/gdata/batchs"http://schemas.google.com/acl/2007s&{http://schemas.google.com/acl/2007}%stinserttupdatetdeletetquerytErrorcBseZRS((t__name__t __module__(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyR5stMissingRequiredParameterscBseZRS((RR(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyR 9st MediaSourcecBs/eZdZddddddZdZRS(sGData Entries can refer to media sources, so this class provides a place to store references to these objects along with some metadata. cCsc||_||_||_||_|djo.|dj o!|dj o|i||ndS(srCreates an object of type MediaSource. Args: file_handle: A file handle pointing to the file to be encapsulated in the MediaSource content_type: string The MIME type of the file. Required if a file_handle is given. content_length: int The size of the file. Required if a file_handle is given. file_path: string (optional) A full path name to the file. Used in place of a file_handle. file_name: string The name of the file without any path information. Required if a file_handle is given. N(t file_handlet content_typetcontent_lengtht file_nametNonetsetFile(tselfR R R t file_pathR((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt__init__Bs     cCsIt|d|_||_tii||_tii||_dS(s%A helper function which can create a file handle from a given filename and set the content type and length all at once. Args: file_name: string The path and file name to the file containing the media content_type: string A MIME type representing the type of the media trbN( topenR R tostpathtgetsizeR tbasenameR(RRR ((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyR\s  N(RRt__doc__RRR(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyR =s t LinkFindercBsVeZdZdZdZdZdZdZdZdZ dZ RS( sXAn "interface" providing methods to find link elements GData Entry elements often contain multiple links which differ in the rel attribute or content type. Often, developers are interested in a specific type of link so this class provides methods to find specific classes of links. This class is used as a mixin in GData entries. cCs0x)|iD]}|idjo|Sq q WdS(sFind the first link with rel set to 'self' Returns: An atom.Link or none if none of the links had rel equal to 'self' RN(tlinktrelR(Rta_link((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt GetSelfLinkvs   cCs0x)|iD]}|idjo|Sq q WdS(Ntedit(RRR(RR((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt GetEditLinks   cCsHxA|iD]6}|idjo|Sn|idjo|Sq q WdS(sgThe Picasa API mistakenly returns media-edit rather than edit-media, but this may change soon. s edit-medias media-editN(RRR(RR((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pytGetEditMediaLinks  cCs@x9|iD].}|idjo|idjo|Sq q WdS(sFind the first link with rel of alternate and type of text/html Returns: An atom.Link or None if no links matched t alternates text/htmlN(RRttypeR(RR((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt GetHtmlLinks    cCs0x)|iD]}|idjo|Sq q WdS(sGet a link containing the POST target URL. The POST target URL is used to insert new entries. Returns: A link object with a rel matching the POST type. s%http://schemas.google.com/g/2005#postN(RRR(RR((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt GetPostLinks   cCs0x)|iD]}|idjo|Sq q WdS(Ns4http://schemas.google.com/acl/2007#accessControlList(RRR(RR((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt GetAclLinks   cCs0x)|iD]}|idjo|Sq q WdS(Ns%http://schemas.google.com/g/2005#feed(RRR(RR((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt GetFeedLinks   cCs0x)|iD]}|idjo|Sq q WdS(Ntnext(RRR(RR((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt GetNextLinks   ( RRRRR!R"R%R&R'R(R*(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyRks    t TotalResultscBsPeZdZdZeZeiii Zeii i Z ddddZ RS(s(opensearch:TotalResults for a GData feedt totalResultscCs-||_|pg|_|ph|_dS(N(ttexttextension_elementstextension_attributes(RR.R/R-((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyRs N( RRRt_tagtOPENSEARCH_NAMESPACEt _namespacetatomtAtomBaset _childrentcopyt _attributesRR(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyR+scCstit|S(N(R3tCreateClassFromXMLStringR+(t xml_string((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pytTotalResultsFromStringst StartIndexcBsPeZdZdZeZeiii Zeii i Z ddddZ RS(s/The opensearch:startIndex element in GData feedt startIndexcCs-||_|pg|_|ph|_dS(N(R-R.R/(RR.R/R-((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyRs N( RRRR0R1R2R3R4R5R6R7RR(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyR;scCstit|S(N(R3R8R;(R9((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pytStartIndexFromStringst ItemsPerPagecBsPeZdZdZeZeiii Zeii i Z ddddZ RS(s1The opensearch:itemsPerPage element in GData feedt itemsPerPagecCs-||_|pg|_|ph|_dS(N(R-R.R/(RR.R/R-((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyRs N( RRRR0R1R2R3R4R5R6R7RR(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyR>scCstit|S(N(R3R8R>(R9((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pytItemsPerPageFromStringst GDataEntrycBs}eZdZeiiZeiiZeiiiZeii iZ dZ dZ e e e Z dZdZRS(s-Extends Atom Entry to provide data processingcCs|iS(N(t_GDataEntry__id(R((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt__GetIdscCs3||_|dj o|ii|i_ndS(N(RBRR-tstrip(Rtid((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt__SetIds  cCs|iotSntSdS(s?Determines whether or not an entry is a GData Media entry. N(R"tTruetFalse(R((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pytIsMedia s cCs#|ipdSn |iiSdS(seReturns the URL to the media content, if the entry is a media entry. Otherwise returns None. N(RIRtcontenttsrc(R((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyt GetMediaURLs (RRRR3tEntryR0R2R5R6R7t_GDataEntry__GetIdt_GDataEntry__SetIdtpropertyRERIRL(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyRAs     cCstit|S(s8Creates a new GDataEntry instance given a string of XML.(R3R8RA(R9((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pytGDataEntryFromStringst GDataFeedcBseZdZdZeiZeiii Zeii i Z de fede This is the text) extension_elements: list (optional) A list of ExtensionElement instances which are children of this element. extension_attributes: dict (optional) A dictionary of strings which are the values for additional XML attributes of this element. N(tauthortcategoryt contributorR[ticonRERtlogotrightstsubtitlettitletupdatedRWRTRURVR-R.R/(RR]R^R_R[R`tatom_idRRaRbRcRdReRWRTRURVR.R/R-((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyRGs&             N(RRRR0R3tATOM_NAMESPACER2tFeedR5R6R7R+R1R;R>RAt_GDataFeed__GetIdt_GDataFeed__SetIdRPREt_GDataFeed__GetGeneratort_GDataFeed__SetGeneratorR[RR(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyRR"s.       cCstit|S(N(R3R8RR(R9((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pytGDataFeedFromString|stBatchIdcBs8eZdZeZeiiiZeii iZ RS(RE( RRR0tBATCH_NAMESPACER2R3R4R5R6R7(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyRnscCstit|S(N(R3R8Rn(R9((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pytBatchIdFromStringstBatchOperationcBsWeZdZeZeiiiZeii iZ de dR@RMRARQRhRRRmRnRpRqRtRuRyRzRRRRRRRRR(((sB/afs/sipb.mit.edu/project/freeculture/lib/python/gdata/__init__.pyssf  .S   & Z    !