^Yc @@s dZddlmZddlZddlmZdZdddd gZdd lmZdd lm Z dd l m Z m Z m Z mZmZddlZydd lmZWn!ek rddlmZnXddlmZddlmZddlZddlZddlZddlZddlZddlZddlZddl Z ddl!m"Z"ddl!m#Z#ddl$m%Z%ddl$m&Z&ddl$m'Z'ddl$m(Z(ddl$m)Z)ddl$m*Z*ddl+m,Z,ddl+m-Z-ddl+m.Z.ddl+m/Z/ddl+m0Z0ddl+m1Z1ddl+m2Z2dd l3m4Z4dd!l3m5Z5dd"l3m6Z6dd#l7m8Z8dd$l9m:Z:y$dd%l;m<Z<dd&l;m=Z=Wn1ek rdd%l>m<Z<dd&l>m=Z=nXd'e_?ej@eAZBejCd(ZDejCd)ZEd*ZFeFZGd+ZHd,ZIeJd-d.d/gZKid0d16d2d36d4d56d6d76ZLid8d96d:d;6eMd<6ZNid=d96d>d;6eOd<6ZPid?d96d>d;6eOd<6ZQeJd@dAdBdCgZRid>d;6dDdE6ZSeJdFgZTdGefdHYZUdIZVdJZWe=dKdeFdde0deMddLZYddMZZe=d'ddddde0ddNZ[dOZ\dPZ]dQZ^dRZ_dSZ`dTZadUZbdVecfdWYZddXZedYZfdZecfd[YZgdS(\sVClient for discovery based APIs. A client library for Google's discovery based APIs. i(tabsolute_importN(tzips$jcgregorio@google.com (Joe Gregorio)tbuildtbuild_from_documenttfix_method_namet key2param(tBytesIO(t http_client(t urlencodeturlparseturljoint urlunparset parse_qsl(tBytesGenerator(t Generator(t MIMEMultipart(tMIMENonMultipart(t_auth(t mimeparse(t HttpError(tInvalidJsonError(tMediaUploadSizeError(tUnacceptableMimeTypeError(tUnknownApiNameOrVersion(tUnknownFileType(t build_http(tBatchHttpRequest(tHttpMock(tHttpMockSequence(t HttpRequest(tMediaFileUpload(t MediaUpload(t JsonModel(t MediaModel(tRawModel(tSchemas(tGoogleCredentials(t_add_query_parameter(t positionalis{[^}]*}s[a-zA-Z0-9_-]+sDhttps://www.googleapis.com/discovery/v1/apis/{api}/{apiVersion}/restsAhttps://{api}.googleapis.com/$discovery/rest?version={apiVersion}s)A description of how to use this functiontPUTtPOSTtPATCHi tKBitMBitGBi(tTBsThe request body.t descriptiontobjectttypetrequiredsOThe filename of the media request body, or an instance of a MediaUpload object.tstringsPThe MIME type of the media request body, or an instance of a MediaUpload object.ttracetpptuseriptstricttquerytlocationtbodyt_BytesGeneratorcB@seZejZRS((t__name__t __module__R twritet _write_lines(((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyR:scC@s+tj|s|tkr#|dS|SdS(sFix method names to avoid reserved word conflicts. Args: name: string, method name. Returns: The name with a '_' prefixed if the name is a reserved word. t_N(tkeywordt iskeywordtRESERVED_WORDS(tname((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyRs cC@syg}t|}|djs2|jdnx7|D]/}|jr[|j|q9|jdq9Wdj|S(sConverts key names into parameter names. For example, converting "max-results" -> "max_results" Args: key: string, the method key name. Returns: A safe method name based on the key name. itxR?t(tlisttisalphatappendtisalnumtjoin(tkeytresulttc((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyRs    ic C@si|d6|d6} |d kr,t} n|} x|tfD]} tj| | } yGt| | || }t|d| d|d|d|d|d|SWq?tk r}|jj t j krq?q|q?Xq?Wt d ||fd S( sAConstruct a Resource for interacting with an API. Construct a Resource object for interacting with an API. The serviceName and version are the names from the Discovery service. Args: serviceName: string, name of the service. version: string, the version of the service. http: httplib2.Http, An instance of httplib2.Http or something that acts like it that HTTP requests will be made through. discoveryServiceUrl: string, a URI Template that points to the location of the discovery service. It should have two parameters {api} and {apiVersion} that when filled in produce an absolute URI to the discovery document for that service. developerKey: string, key obtained from https://code.google.com/apis/console. model: googleapiclient.Model, converts to and from the wire format. requestBuilder: googleapiclient.http.HttpRequest, encapsulator for an HTTP request. credentials: oauth2client.Credentials or google.auth.credentials.Credentials, credentials to be used for authentication. cache_discovery: Boolean, whether or not to cache the discovery doc. cache: googleapiclient.discovery_cache.base.CacheBase, an optional cache object for the discovery documents. Returns: A Resource object with methods for interacting with the service. tapit apiVersiontbasethttpt developerKeytmodeltrequestBuildert credentialssname: %s version: %sN( tNoneRtV2_DISCOVERY_URIt uritemplatetexpandt_retrieve_discovery_docRRtresptstatusRt NOT_FOUNDR(t serviceNametversionRQtdiscoveryServiceUrlRRRSRTRUtcache_discoverytcachetparamstdiscovery_httpt discovery_urlt requested_urltcontentte((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyRs((    c C@sp|rfddlm}ddlm}|d krA|j}n|rf|j|}|rc|Sqfn|}dtjkrt|dtjd}nt j d||j |\}}|j dkrt ||d|ny|jd }Wntk r nXytj|} Wn-tk rL} t jd |tnX|rl|rl|j||n|S( sRetrieves the discovery_doc from cache or the internet. Args: url: string, the URL of the discovery document. http: httplib2.Http, An instance of httplib2.Http or something that acts like it through which HTTP requests will be made. cache_discovery: Boolean, whether or not to cache the discovery doc. cache: googleapiclient.discovery_cache.base.Cache, an optional cache object for the discovery documents. Returns: A unicode string representation of the discovery document. i(tdiscovery_cache(RPt REMOTE_ADDRtuserIpsURL being requested: GET %siturisutf-8sFailed to parse as JSON: N(RERiRPRVt autodetecttgettostenvironR%tloggertinfotrequestR\RtdecodetAttributeErrortjsontloadst ValueErrorterrorRtset( turlRQRaRbRiRPRgt actual_urlR[tserviceRh((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyRZs8     c C@s|dk r'|dk r'tdnt|tjrKtj|}nd|krt|ttfrt j ddddt nt |d|d}t |}|dkrNt|jdijd ijd ij} | rB| rB|dkrtj}ntj|| }tj|}qNt}n|dkr|jd g} td | k}ntd |d|d|d|d|d|d|d|S(sCreate a Resource for interacting with an API. Same as `build()`, but constructs the Resource object from a discovery document that is it given, as opposed to retrieving one over HTTP. Args: service: string or object, the JSON discovery document describing the API. The value passed in may either be the JSON string or the deserialized JSON. base: string, base URI for all HTTP requests, usually the discovery URI. This parameter is no longer used as rootUrl and servicePath are included within the discovery document. (deprecated) future: string, discovery document with future capabilities (deprecated). http: httplib2.Http, An instance of httplib2.Http or something that acts like it that HTTP requests will be made through. developerKey: string, Key for controlling API usage, generated from the API Console. model: Model class instance that serializes and de-serializes requests and responses. requestBuilder: Takes an http request and packages it up to be executed. credentials: oauth2client.Credentials or google.auth.credentials.Credentials, credentials to be used for authentication. Returns: A Resource object with methods for interacting with the service. s6Arguments http and credentials are mutually exclusive.trootUrls2You are using HttpMock or HttpMockSequence withouts7having the service discovery doc in cache. Try calling s3build() without mocking once first to populate the scache.t servicePathtauthtoauth2tscopestfeaturest dataWrapperRQtbaseUrlRSRRRTt resourceDesctrootDesctschemaN(RVRxt isinstancetsixt string_typesRvRwRRRqRyRR R#RFRntkeysRtdefault_credentialst with_scopestauthorized_httpRR tResource( R}RPtfutureRQRRRSRTRURRR((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyR's6&     3     cC@s|dkrMt|tdks<t|tdkr@|St|Sn|dkritt|S|dkrtt|S|dkrtt|jSt|tdkst|tdkr|St|SdS(sVConvert value to a string based on JSON Schema type. See http://tools.ietf.org/html/draft-zyp-json-schema-03 for more details on JSON Schema. Args: value: any, the value to convert schema_type: string, the type that value should be interpreted as Returns: A string representation of 'value' based on the schema_type. R2REutintegertnumbertbooleanN(R0tstrtinttfloattbooltlower(tvaluet schema_type((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyt_casts 0    0cC@sat|dkrdS|dj}tj|}|dk rSt|d |>St|SdS(sConvert a string media size, such as 10GB or 3TB into an integer. Args: maxSize: string, size as a string, such as 2MB or 7GB. Returns: The size as an integer value. iiiN(tlentuppert_MEDIA_SIZE_BIT_SHIFTSRnRVR(tmaxSizetunitst bit_shift((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyt_media_size_to_longs  cC@s%di|dd6|dd6|d6S(sCreates an absolute media path URL. Constructed using the API root URI and service path from the discovery document and the relative path for the API method. Args: root_desc: Dictionary; the entire original deserialized discovery document. path_url: String; the relative URL for the API method. Relative to the API root, which is specified in the discovery document. Returns: String; the absolute URI for media upload for the API method. s'%(root)supload/%(service_path)s%(path)sR~trootRt service_pathtpath((t root_desctpath_url((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyt_media_path_url_from_infos  cC@s|jdi}x3tj|jdiD]\}}|||d!|f|j?|j@|jA|d"d|d#|d$d|S(%Ns'Got an unexpected keyword argument "%s"sMissing required parameter "%s"s9Parameter "%s" value "%s" does not match the pattern "%s"s9Parameter "%s" value "%s" is not an allowed value in "%s"R2R9RRRKt_mediatresponseREsDmedia_mime_type argument not specified: trying to auto-detect for %st,tmimetypes*media_filename must be str or MediaUpload.isMedia larger than: %st uploadTypet resumables content-typetmediatrelatedt_write_headerscS@sdS(N(RV(R((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pytEsRtbinarysContent-Transfer-Encodingt mangle_from_tunixfroms multipart/related; boundary="%s"t multipartsURL being requested: %s %stmethodtheaderstmethodId(BRtiterkeysRt TypeErrorRFRRVRRRRRtreRRRRRRnR0RRRt _developerKeyt_modelRR!R"RsRXRYRt_baseUrlRqtwarningt mimetypest guess_typeRRt best_matchRJRRRtsizeRRR%RtgetbytesRtsetattrRtsplitt set_payloadtattachRR:Rtflattentgetvaluet get_boundaryRrt_requestBuildert_httpR(#RtkwargsRCRtregextpvaluestpvaluetenumstvaluesRtactual_query_paramstactual_path_paramsRKtto_typeRDt cast_valuet body_valuetmedia_filenameRRSRRcR7R9t expanded_urlR{Rtmultipart_boundaryR?RtmsgRoottmsgtpayloadtfptg( RRRt mediaPathUrlt methodDescRt methodNameRtpathUrl(sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyRs     !     ''%            4               R.s isArgs: RtparameterOrderR9REs (repeated)s (required)s A parameters$refs< %s: object, %s%s%s The object takes the form of: %s R0R2s %s: %s, %s%s%s RtenumDescriptionss Allowed values s %s - %s RRs/ Returns: The media object as a string. s( Returns: An object of the form: R(RRRRntDEFAULT_METHOD_DOCRRRHRFRtextendRRRRtprettyPrintByNameRRtprettyPrintSchemaRRJ(R!R RRRtdocstskip_parameterstall_argstst args_orderedRCRRR1t paramdesctparamdoct paramtypeRtenumDescR(( RRRRR RR!RR"sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyt createMethods` ! ' +            "  c@s%tfd}|fS(sCreates any _next methods for attaching to a Resource. The _next methods allow for easy iteration through list() responses. Args: methodName: string, name of the method to use. c @sd|ks|d rdStj|}|d}tt|j}t|d}g|D]$\}}|dkr`||f^q`} | jd|ft| |dR?t_add_nested_resourcest_add_next_methods(R((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyR@sc @s||krQd|d|jddfdfd}|jd|nd|krxtj|dD]\}}t||||\}}|j||j||j|jdtrqt|d |||\}}|j||j||jqqqqWndS( Ns%s%sR~t batchPathtbatchc@std|dS(sQCreate a BatchHttpRequest object based on the discovery document. Args: callback: callable, A callback to be called for each response, of the form callback(id, response, exception). The first parameter is the request id, and the second is the deserialized response object. The third is an apiclient.errors.HttpError exception object if an HTTP error occurred while processing the request, or None if no error occurred. Returns: A BatchHttpRequest object based on the discovery document. tcallbackt batch_uri(R(RN(RO(sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pytnew_batch_http_requestsRPtmethodstsupportsMediaDownloadR( RnRVRCRRR2t__get__t __class__R( RRRRRPR!R tfixedMethodNameR((ROsK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyRIs      c @s}d|kryfd}xXtj|dD]@\}}|||\}}|j||j||jq2WndS(Nt resourcesc@sKt|}fd}t|ddt|dt||fS(sCreate a method on the Resource to access a nested Resource. Args: methodName: string, name of the method to use. methodDesc: object, fragment of deserialized discovery document that describes the method. c@sFtd|jd|jd|jd|jd|jdddS( NRQRRSRRRTRRR(RR RRRR (R(R RR(sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pytmethodResourceMs   RsA collection resource.t__is_resource__(RRtTrue(R!R RW(RR(R sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pytcreateResourceMethodCs  (RRRCRSRT( RRRRRZR!R RUR((RRsK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyRJ?s    c C@sd|krxtj|dD]\}}d|kr |d}d|krd|j|d}nd|jdik}d|jdik}|r|rt|d\}} |j|| j||jqq q WndS( NRQRs$refR3t propertiesR4Rt_next(RRRnR;RCRSRT( RRRR!R tresponseSchemathasNextPageTokent hasPageTokenRUR((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyRK^s         ( R;R<RRRCRFRHR@RIRJRK(((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyRs  % (hRt __future__RRt six.movesRt __author__t__all__RRtsix.moves.urllib.parseRR R R R Rtemail.generatorR t ImportErrorRtemail.mime.multipartRtemail.mime.nonmultipartRRvR@tloggingRRoRthttplib2RXtgoogleapiclientRRtgoogleapiclient.errorsRRRRRRtgoogleapiclient.httpRRRRRRRtgoogleapiclient.modelR R!R"tgoogleapiclient.schemaR#toauth2client.clientR$toauth2client.utilR%R&toauth2client._helperstRETRIESt getLoggerR;RqtcompileRRt DISCOVERY_URItV1_DISCOVERY_URIRWR%t frozensetRRRYRRRRRRRBR:RRRVRRZRRRRRRRRR/RR2R;R(((sK/tmp/pip-build-kpPAdC/google-api-python-client/googleapiclient/discovery.pyts  (            "      ; 5 R    + - - X 0