O'^c@sFddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZmZdd lmZmZmZdd lmZmZmZmZmZdd lmZdd lmZddl m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)ej*dZ+e%i dej,6dej-6dej.6dej/6dej06dej16dej26dej36dej46dej56Z6dZ7dZ8dZ9dZ:dZ;d Z<d!Z=d"e>fd#YZ?d$e>fd%YZ@eAeAeAd&ZBdS('iN(t OrderedDict(t import_module(tsettings(tsimplify_regex(tPermissionDenied(tHttp404(tsix(t force_textt smart_text(t exceptionst rendererst serializers(tRegexURLPatterntRegexURLResolvertcoreapit uritemplateturlparse(t clone_request(tResponse(t api_settings(t formatting(tClassLookupDict(t_get_pk(tAPIViews^[a-zA-Z][0-9A-Za-z_]*:tstringtintegertnumbertbooleantfiletarraytobjectcCsg|D]}|jdjd^q}t|}t|}|}x8t|D]*\}}|||krV|| }PqVqVWddj|S(Nt/(tstriptsplittmintmaxt enumeratetjoin(tpathstpatht split_pathsts1ts2tcommontitc((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyt common_path)s+   cCs|jjj}t|jS(N(t_metatconcrete_modelRtname(tmodeltmeta((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyt get_pk_name5scCs+t|dd}|dk o*t|tS(sT Return `True` if the given view callback is a REST framework view/viewset. tclsN(tgetattrtNonet issubclassR(tcallbackR5((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyt is_api_view:scCsJx5|d D])}||kr*i||>> example = {} >>> insert_into(example, ['a', 'b', 'c'], 123) >>> example {'a': {'b': {'c': 123}}} iN((ttargettkeystvaluetkey((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyt insert_intoBs   cCs"|tddddddgkS(Ntretrievetlisttcreatetupdatetpartial_updatetdestroy(tset(taction((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pytis_custom_actionRscCsht|dr|jdkS|jdkr2tS|jdjd}|rdd|dkrdtStS(sP Return True if the given path/method appears to represent a list view. RGRAtgetRt{i(thasattrRGtlowertFalseR R!tTrue(R'tmethodtviewtpath_components((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyt is_list_viewXs cCsN|\}}}idd6dd6dd6dd6d d 6j|d }||fS( NitGETitPOSTitPUTitPATCHitDELETEi(RI(tendpointR'ROR9tmethod_priority((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pytendpoint_orderinghs  tEndpointInspectorcBsGeZdZdddZdddZdZdZdZRS(sR A class to determine the available API endpoints that a project exposes. cCsd|dkrW|dkr$tj}nt|tjrEt|}n|}|j}n||_dS(N( R7Rt ROOT_URLCONFt isinstanceRt string_typesRt urlpatternstpatterns(tselfR`turlconfturls((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyt__init__xs    tc Cs|dkr|j}ng}x|D]}||jj}t|tr|j|}|j}|j||rx6|j |D]"}|||f} |j | qWqq%t|t r%|j d|j d|} |j| q%q%Wt|dt}|S(sZ Return a list of all available API endpoints by inspecting the URL conf. R`tprefixR>N(R7R`tregextpatternR]R tget_path_from_regexR9tshould_include_endpointtget_allowed_methodstappendR tget_api_endpointst url_patternstextendtsortedRZ( RaR`Rft api_endpointsRht path_regexR'R9RORXtnested_endpoints((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyRms&       cCs.t|}|jddjdd}|S(sG Given a URL conf regex, return a URI template string. tt}(Rtreplace(RaRrR'((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyRis cCs6t|stS|jds.|jdr2tStS(sI Return `True` if the given endpoint should be included. s .{format}s .{format}/(R:RMtendswithRN(RaR'R9((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyRjs  cCsat|dr5g|jjD]}|j^qSg|jjD]}|dkrE|^qES(sL Return a list of the valid HTTP methods for this endpoint. tactionstOPTIONStHEAD(RzR{(RKRyR<tupperR5tallowed_methods(RaR9RO((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyRks&N( t__name__t __module__t__doc__R7RdRmRiRjRk(((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyR[ts   tSchemaGeneratorcBseZidd6dd6dd6dd6dd 6ZeZdZdZddddd Zdd Z dd Z d Z ddZ dZ dZdZdZdZdZdZdZdZdZRS(R@RIRBtpostRCtputRDtpatchREtdeletecCs~tstd|r5|jd r5|d7}ntj|_tj|_||_||_ ||_ ||_ d|_ dS(Ns/`coreapi` must be installed for schema support.R(RtAssertionErrorRxRtSCHEMA_COERCE_METHOD_NAMEStcoerce_method_namestSCHEMA_COERCE_PATH_PKtcoerce_path_pkR`RbttitleturlR7t endpoints(RaRRR`Rb((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyRds       cCst|jdkr9|j|j|j}|j|_n|j|}|sRdStjd|j d|j d|S(sL Generate a `coreapi.Document` representing the API schema. RRtcontentN( RR7tendpoint_inspector_clsR`RbRmt get_linksRtDocumentRR(Ratrequestt inspectortlinks((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyt get_schemasc Cs3t}g}g}x|jD]t\}}}|j|||}t|dtr[qn|j|||}|j||j|||fqW|sdS|j|} x||D]t\}}}|j |||sqn|j |||} |t | } |j | ||} t || | qW|S(sq Return a dictionary containing all the links that should be included in the API schema. texclude_from_schemaN(RRt create_viewR6RMt coerce_pathRlR7tdetermine_path_prefixthas_view_permissionstget_linktlentget_keysR?( RaRRR&tview_endpointsR'ROR9RPRftlinktsubpathR<((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyRs*  cCsg}x|D]}|jdjd}g}x+|D]#}d|krNPn|j|q8Wdj|d }|s|dS|jd|dq Wt|S(s Given a list of all paths, return the common prefix which should be discounted when generating a schema structure. This will be the longest common string that does not include that last component of the URL, or the last component before a path parameter. For example: /api/v1/users/ /api/v1/users/{pk}/ The path prefix is '/api/v1/' RRJi(R R!RlR%R.(RaR&tprefixesR't componentstinitial_componentst componentRf((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyRs   cCs|j}x6t|dijD]\}}t|||q%Wd|_i|_d|_d|_t|dd|_ t|dd}|dk r|dkrd|_ q|j |j |_ n|dk rt |||_n|S(sC Given a callback, return an actual view instance. t initkwargsRyRztmetadata(N(R5R6titemstsetattrtargstkwargsR7t format_kwargRt action_mapRGRIRLR(RaR9RORRPtattrtvalRy((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyR8s  %        cCsL|jdkrtSy|j|jWntjttfk rGtSXtS(sY Return `True` if the incoming request has the correct view permissions. N( RR7RNtcheck_permissionsR t APIExceptionRRRM(RaR'RORP((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyRQscCsg|j sd|kr|Stt|dddd}|rMt|}nd}|jdd|S(s Coerce {pk} path arguments into the name of the model field, where possible. This is cleaner for an external representation. (Ie. "this is an identifier", not "this is a database primary key") s{pk}tquerysetR2tids{%s}N(RR6R7R4Rw(RaR'RORPR2t field_name((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyR^sc Cs#|j|||}||j|||7}||j|||7}||j|||7}|rtg|D]}|jd k^qpr|j|||}nd }|j|||}|j r|j dr|d}nt j dt j|j |d|jd|d|d |S( sJ Return a `coreapi.Link` instance for the given endpoint. tformtbodyRiRRGtencodingtfieldst description(RRN(tget_path_fieldstget_serializer_fieldstget_pagination_fieldstget_filter_fieldstanytlocationt get_encodingR7tget_descriptionRt startswithRtLinkRturljoinRL(RaR'RORPRtfieldRR((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pyRos .   cCsct|d|j}t||dj}|rFtjt|S|j}g|jD]}|j ^q_}d} idd6} x\|D]T}t j |r|j d\} } } | j | | s  (Ctret collectionsRt importlibRt django.confRtdjango.contrib.admindocs.viewsRtdjango.core.exceptionsRt django.httpRt django.utilsRtdjango.utils.encodingRRtrest_frameworkR R R trest_framework.compatR R RRRtrest_framework.requestRtrest_framework.responseRtrest_framework.settingsRtrest_framework.utilsRt"rest_framework.utils.field_mappingRtrest_framework.utils.model_metaRtrest_framework.viewsRtcompileRRt IntegerFieldt FloatFieldt DecimalFieldt BooleanFieldt FileFieldtMultipleChoiceFieldtManyRelatedFieldRRRR.R4R:R?RHRRRZRR[RR7R(((s8/tmp/pip-unpacked-wheel-62FVgP/rest_framework/schemas.pytsP (               Ry