U ŻZßf_ć@sbddlmZmZmZmZddlZddlmZddlm Z ddl m Z m Z m Z mZmZmZmZddlmZddlmZmZmZmZmZmZmZmZdZer ddlZddlZe  e!d ƒ”Z"d Z#e $d ”Z%d Z&e"j'd ddZ(e(j)ddde!dde(j)ddde!dde(j)ddde!dde(j)ddde!dde(j)d d!e!d"d#e(j)d$d%d&e!gd'd(Gd)d*„d*eƒZ*dS)+é)Śabsolute_importŚdivisionŚprint_functionŚunicode_literalsN)Ś CodeBackend)Śfmt_underscores)Ścheck_route_name_conflictŚ fmt_classŚfmt_funcŚ fmt_namespaceŚfmt_objŚfmt_typeŚfmt_var)Śclass_name_for_data_type)Śis_nullable_typeŚ is_list_typeŚ is_map_typeŚis_struct_typeŚ is_tag_refŚ is_union_typeŚis_user_defined_typeŚ is_void_typeFŚargparsezŽ# -*- coding: utf-8 -*- # Auto-generated by Stone, do not modify. # flake8: noqa # pylint: skip-file from abc import ABCMeta, abstractmethod z:(?P[A-z]*):`(?P.*?)`a+If you do not consume the entire response body, then you must call close on the response object, otherwise you will max out your available connections. We recommend using the `contextlib.closing `_ context manager to ensure this.zpython-client-backendzŲGenerates a Python class with a method for each route. Extend the generated class and implement the abstract request() method. This class assumes that the python_types backend was used with the same output directory.)ŚprogŚ descriptionz-mz --module-nameTzQThe name of the Python module to generate. Please exclude the .py file extension.)ŚrequiredŚtypeŚhelpz-cz --class-namezBThe name of the Python class that contains each route as a method.z-tz--types-packagez6The output Python package of the python_types backend.z-ez--error-class-pathz.exceptions.ApiErrorz}The path to the class that's raised when a route returns an error. The class name is inserted into the doc for route methods.)Śdefaultrrz-wz --auth-typez(The auth type of the client to generate.)rrz-az--attribute-commentŚappendzļRoute attributes that the backend will have access to and presumably expose in generated code. Use ":all" to select all attributes defined in stone_cfg.Route. Attributes will be exposed in the documentation, as the client doesn't use them.)Śactionrrrc@sreZdZeZdZdd„Zdd„Zdd„Zdd „Z dd d „Z ddd„Z dd„Z ddd„Z dd„Zdd„Zdd„ZdS)ŚPythonClientBackendNc Cs| d|jj”ś| t”d}|j ”D]0}|jD]}|jr6|  d”d}qTq6|r,q^q,|  ”|  |j ””|  ”|  ”|  d|jj ”|  ”b|  d”|  ”|  d”|  d”|  ”|  d ”W5QRX|  ”|  |j ””W5QRXW5QRXd S) zžGenerates a module called "base". The module will contain a base class that will have a method for each route across all namespaces. z%s.pyFzimport warningsTzclass %s(object):z__metaclass__ = ABCMetaz@abstractmethodz:def request(self, route, namespace, arg, arg_binary=None):ŚpassN)Zoutput_to_relative_pathŚargsŚ module_nameZemit_rawŚbaseŚ namespacesŚvaluesŚroutesŚ deprecatedŚemitŚ_generate_importsŚ class_nameŚindentŚ_generate_route_methods)ŚselfŚapiZfound_deprecatedŚ namespaceŚroute©r3ś@/tmp/pip-unpacked-wheel-vqb3mfeu/stone/backends/python_client.pyŚgenerate~s6      ’ zPythonClientBackend.generatecCs0|D]&}|jr| d |jjt|jƒ””qdS)Nzfrom {} import {})Ś data_typesr*Śformatr#Ś types_packager Śname©r/r&r1r3r3r4r+”sz%PythonClientBackend._generate_importscCsHd|_|D]8}|jr | d”| d |j””| ”| |”q dS)zvCreates methods for the routes in each namespace. All data types and routes are represented as Python classes.Nz,# ------------------------------------------z# Routes in {} namespace)Ś cur_namespacer(r*r7r9Ś_generate_routesr:r3r3r4r.§s z+PythonClientBackend._generate_route_methodscCsō||_|jjdk r,dd„|jj d”Dƒ|_t|ƒ|jD]“}|jdkrt| ||”|j  d”dkrī| ||d”q:d}|jdk rŽ|j  d”}|dkr˜q:d d„| d”Dƒ}|jD]:}||kr²| ||”|j  d”dkrč| ||d”q:q²q:dS) zV Generates Python methods that correspond to routes in the namespace. NcSsg|]}| ” ”‘qSr3©ŚstripŚlower)Ś.0Ś auth_typer3r3r4Ś ¼sz8PythonClientBackend._generate_routes..ś,ŚstyleŚdownloadTŚauthcSsg|]}| ” ”‘qSr3r=)r@Śmoder3r3r4rBĶs) r;r#rAŚsplitŚsupported_auth_typesrr(Ś_generate_route_helperŚattrsŚget)r/r1r2Zroute_auth_attrZroute_auth_modesZbase_auth_typer3r3r4r<²s*        z$PythonClientBackend._generate_routesFc Cs|j}|j}|j d”dk}|j d”dk}|rV|sPythonClientBackend._generate_route_helper..z arg = {}.{})ŚbeforezUnhandled request type %rz{}.{}©Śversionś'{}'ŚargrQŚNonezr = self.requestF)Ścompactz,self._save_body_to_file(download_path, r[1])z return Nonez return r[0]zreturn r)Ś arg_data_typeŚresult_data_typerKrLŚAssertionErrorŚ_generate_route_method_declr-ŚDOCSTRING_CLOSE_RESPONSEŚdocŚ process_docŚ_docfŚ_generate_docstring_for_funcŚerror_data_typeŚ#_maybe_generate_deprecation_warningrr*rŚgenerate_multiline_listŚ all_fieldsr7r r1r9r rr rZr) r/r1r2Zdownload_to_filer_r`Śrequest_binary_bodyZresponse_binary_bodyrUrVrWZfunc_docstringr#r3r3r4rJÕsš  ūż ÷    žž ’ ’ ü        z*PythonClientBackend._generate_route_helperŚc Csdg}|r||7}|r | d”t|ƒr¢|jD]p}t|jƒrP| d |j””q.|jr’t|jƒrj|jj } nd} d |j|  | |j ””} | | ”q.| |j”q.n(t |ƒr¶| d”nt |ƒsŹtd|ƒ‚t|j||jd} t|jƒ} | |d  | | ”d ”dS) z+Generates the method prototype for a route.r/rQz{}=NoneNz{}={}r\zUnhandled request type: %rrYz def {}_{}ś:)rrrkrŚ data_typer7r9Z has_defaultrr1Ś_generate_python_valuerrrrar rZrrj) r/r1r2r_rlrOrPr#ŚfieldŚnsr\Ś method_nameZnamespace_namer3r3r4rb=s8      ž  ’ z/PythonClientBackend._generate_route_method_declcCsR|jrNd |j”}|jjr.|d |jjj”7}d |”dg}|j|dddddS) Nz{} is deprecated.z Use {}.r[ŚDeprecationWarningz warnings.warn)ś(ś)F)rXŚdelimr^)r)r7r9Zbyrj)r/r2Śmsgr#r3r3r4rics üz7PythonClientBackend._maybe_generate_deprecation_warningc  Csnt|ƒr gn|j} g} |jjrZ| rZ|jjD].} | | kr*| | dk r*|  d | | | ””q*| sj|sj| sjdS| d”|r‚| |”| r²|r’| ”| d”| D]} | | d”q |s¼| r0|sÄ| rĢ| ”|r|D]D\}}}|rd |||”}|j|ddqÖ|jd ||”ddqÖt|ƒrę| D]ø}|j r¾t |j ƒr^d |j |  |j |j””}n&d | ||j ”|j |  |j |j””}|j|ddt |j ƒrą| d  |j | ||j ”””n"d  |j | ||j ””}| |”q*nJt|ƒr0|j r|jd  |  |j |j””dd| d  | ||”””|s<| rP|sP| sP| ”|ržg}t|ƒrp| d ”n| ||”}| |”| |”| |d ”n2t|ƒr“| d”n| ||”}| d |””t|ƒsH|jrH| d |jj””| ”|jj dd”d}| d |””| ”| | ||””W5QRX|r`| ”| |”| d”dS)a‹ Generates a docstring for a function or method. This function is versatile. It will create a docstring using all the data that is provided. :param arg_data_type: The data type describing the argument to the route. The data type should be a struct, and each field will be treated as an input parameter of the method. :param result_data_type: The data type of the route result. :param error_data_type: The data type of the route result in the case of an error. :param str overview: A description of the route that will be located at the top of the docstring. :param extra_request_args: [(field name, field type, field doc), ...] Describes any additional parameters for the method that aren't a field in arg_data_type. :param str extra_return_arg: Name of an additional return type that. If this is specified, it is assumed that the return of the function will be a tuple of return_data_type and extra_return-arg. :param str footer: Additional notes at the end of the docstring. Nz{}: {}z"""zRoute attributes:z z:param {} {}: {})Zsubsequent_prefixz :param {}: {}z :type {}: {}z:param arg: {}z :type arg: {}r]z:rtype: z :rtype: Nonez :rtype: {}z:raises: :class:`{}`Ś.éé’’’’z If this raises, {} will contain:)rŚfieldsr#Zattribute_commentrr7r*Zemit_wrapped_textrrdrror9rerfŚ_format_type_in_docrrjZerror_class_pathŚrsplitr-)r/r1r_r`rhrTrUrVrWrKr|Z attrs_linesŚ attributeŚar9Zdata_type_namerdZ field_docrqr#ZrtypeZerror_class_namer3r3r4rgpsÄ       ’’ ž  ’ ż’  ž ž ’ž ’  ’       z0PythonClientBackend._generate_docstring_for_funccCs|dkr4|}d|kr$|jjd|}d |jj|”S|dkr–d|kr^| dd”\}}t|ƒ}nd}d|kr|d t||d”Sd  |jjt||d”Sn||d krŗ| d d”\}}d  ||”S|d krņ|dkrĪdS|dksŽ|dkrģd |  ””S|Sn |dkrd |”St d|ƒ‚dS)z• Callback used as the handler argument to process_docs(). This converts Babel doc references to Sphinx-friendly annotations. rryz:class:`{}.{}`r2rnrzz :meth:`{}`rYz :meth:`{}_{}`Ślinkś z `{} <{}>`_ŚvalŚnullr]ŚtrueŚfalsez``{}``rqzUnknown doc ref tag %rN) r;r9r7r#r8rHŚintr r~Ś capitalizeŚ RuntimeError)r/ŚtagrƒZfq_valrZŚanchorrr3r3r4rfs8  ’   zPythonClientBackend._docfcCs˜t|ƒr dSt|ƒr,d |jj|jt|ƒ”St|ƒrHd | ||j ””St |ƒrdd | ||j ””St |ƒrŒd | ||j ”| ||j ””St|ƒSdS)zo Returns a string that can be recognized by Sphinx as a type reference in a docstring. r]z:class:`{}.{}.{}`z Nullable[{}]zList[{}]z Map[{}, {}]N)rrr7r#r8r9r rr}rorrZ key_data_typeZvalue_data_type)r/r1ror3r3r4r})s,’ ’ ’  žz'PythonClientBackend._format_type_in_doccCs4t|ƒr(d t|jƒt|jƒt|jƒ”St|ƒSdS)Nz{}.{}.{}) rr7r r9rZunion_data_typerZtag_namer )r/r1Śvaluer3r3r4rpCsżz*PythonClientBackend._generate_python_value)F)rmN)NNNNNNN)Ś__name__Ś __module__Ś __qualname__Ś_cmdline_parserZcmdline_parserrIr5r+r.r<rJrbrirgrfr}rpr3r3r3r4r!ys.# # jž &ż $r!)+Ś __future__rrrrŚreZ stone.backendrZstone.backends.helpersrZstone.backends.python_helpersrr r r r r rZstone.backends.python_typesrZstone.irrrrrrrrrZ_MYPYŚtypingŚ importlibŚ import_modulerSrr%ŚcompileZdoc_sub_tag_rercŚArgumentParserrŚ add_argumentr!r3r3r3r4Śsz  $ (  żūūūś üś