a x=ic/@sdZddlZddlmZmZddlmZddlmZm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZdd lmZed gdZedgdZddZddZGdddZGdddeZGddde jZGdddeZ dS)a Routers provide a convenient and consistent way of automatically determining the URL conf for your API. They are used by simply instantiating a Router class, and then registering all the required ViewSets with that router. For example, you might have a `urls.py` that looks something like this: router = routers.DefaultRouter() router.register('users', UserViewSet, 'user') router.register('accounts', AccountViewSet, 'account') urlpatterns = router.urls N) OrderedDict namedtuple)ImproperlyConfigured)NoReverseMatchre_path)views)Response)reverse)SchemaGenerator) SchemaView) api_settings)format_suffix_patternsRouteurlmappingnamedetail initkwargs DynamicRouterrrrcCs|ddddS)zK Double brackets in regex of url_path for escape string formatting {z{{}z}})replace)url_pathrg/home/droni/.local/share/virtualenvs/DPS-5Je3_V2c/lib/python3.9/site-packages/rest_framework/routers.pyescape_curly_brackets"srcCs tj|S)zX Takes an iterable of iterables, returns a single iterable containing all items ) itertoolschain)Z list_of_listsrrrflatten)sr c@s:eZdZddZd ddZddZdd Zed d ZdS) BaseRoutercCs g|_dS)N)registryselfrrr__init__1szBaseRouter.__init__NcCs6|dur||}|j|||ft|dr2|`dSN_urls)get_default_basenamer"appendhasattrr')r$prefixviewsetbasenamerrrregister4s   zBaseRouter.registercCs tddS)q If `basename` is not specified, attempt to automatically determine it from the viewset. z'get_default_basename must be overriddenNNotImplementedError)r$r,rrrr(=szBaseRouter.get_default_basenamecCs tddS)zO Return a list of URL patterns, given the registered viewsets. zget_urls must be overriddenNr0r#rrrget_urlsDszBaseRouter.get_urlscCst|ds||_|jSr&)r*r2r'r#rrrurlsJs  zBaseRouter.urls)N) __name__ __module__ __qualname__r%r.r(r2propertyr3rrrrr!0s  r!c seZdZeddddddddid ed d did ed dddddddddid edd did gZd&fdd ZddZddZddZ dd Z d'd"d#Z d$d%Z Z S)( SimpleRouterz^{prefix}{trailing_slash}$listcreate)getpostz{basename}-listFsuffixListrz%^{prefix}/{url_path}{trailing_slash}$z{basename}-{url_name}rz#^{prefix}/{lookup}{trailing_slash}$retrieveupdateZpartial_updatedestroy)r;putpatchdeletez{basename}-detailTInstancez.^{prefix}/{lookup}/{url_path}{trailing_slash}$cs|rdnd|_tdS)N/)trailing_slashsuperr%)r$rH __class__rrr%~szSimpleRouter.__init__cCs*t|dd}|dusJd|jjjS)r/querysetNz`basename` argument not specified, and could not automatically determine the name from the viewset, as it does not have a `.queryset` attribute.)getattrmodel_metaZ object_namelower)r$r,rLrrrr(s z!SimpleRouter.get_default_basenamecsttddjD|}fdd|D}|rLd}t|d|dd|D}dd|D}g}jD]bttrjr|fdd|D7}qrttrʈjs|fd d|D7}qr| qr|S) z Augment `self.routes` with any dynamically generated routes. Returns a list of the Route namedtuple. cSs g|]}t|tr|jqSr) isinstancerrvalues).0routerrr z+SimpleRouter.get_routes..csg|]}|jvr|jqSr)r4rSaction) known_actionsrrrUs zZCannot use the @action decorator on the following methods, as they are existing routes: %sz, cSsg|]}|jr|qSrrrWrrrrUrVcSsg|]}|js|qSrrZrWrrrrUrVcsg|]}|qSr_get_dynamic_routerWrTr$rrrUrVcsg|]}|qSrr[rWr]rrrUrV) r9r routesZget_extra_actionsrjoinrQrrr))r$r,Z extra_actions not_allowedmsgZdetail_actionsZ list_actionsr^r)rYrTr$r get_routess$   zSimpleRouter.get_routescCsL|j}||jt|j}t|jd||j |j d|j |j |dS)Nz {url_path}z {url_name}r) rcopyr@kwargsrrrrrrrurl_namer)r$rTrXrrrrrr\s    zSimpleRouter._get_dynamic_routecCs,i}|D]\}}t||r |||<q |S)z Given a viewset, and a mapping of http methods to actions, return a new mapping which only includes any mappings that are actually implemented by the viewset. )itemsr*)r$r,Z method_mapZ bound_methodsmethodrXrrrget_method_maps   zSimpleRouter.get_method_maprGcCs<d}t|dd}t|ddp|}t|dd}|j|||dS) a Given a viewset, return the portion of URL regex that is used to match against a single instance. Note that lookup_prefix is not used directly inside REST rest_framework itself, but is required in order to nicely support nested router implementations, such as drf-nested-routers. https://github.com/alanjds/drf-nested-routers z5(?P<{lookup_prefix}{lookup_url_kwarg}>{lookup_value}) lookup_fieldpklookup_url_kwargNZlookup_value_regexz[^/.]+) lookup_prefixrk lookup_value)rMformat)r$r,rlZ base_regexrirkrmrrrget_lookup_regexs   zSimpleRouter.get_lookup_regexc Csg}|jD]\}}}||}||}|D]}|||j}|sDq,|jj|||jd} |s|| dddkr|d| dd} |j } | ||j d|j |fi| } |j j|d} |t| | | dq,q |S) zQ Use the registered viewsets to generate a list of URL patterns. )r+lookuprHNz^/^)r-rr-r)r"rorbrhrrrnrHrrcr@ras_viewrr)r) r$retr+r,r-rpr^rTrregexrviewrrrrr2s0    zSimpleRouter.get_urls)T)rG)r4r5r6rrr^r%r(rbr\rhror2 __classcell__rrrJrr8QsP + $ r8c@s$eZdZdZdZdZdZddZdS) APIRootViewz7 The default basic root view for DefaultRouter TNc Osrt}|jj}|jD]P\}}|r0|d|}z t|||||dd||<WqtyfYqYq0qt|S)N:rn)argsrdrequestrn) rZresolver_match namespace api_root_dictrfr r;rr)r$r}r|rdrvr~keyrerrrr;s    zAPIRootView.get)r4r5r6__doc__Z_ignore_model_permissionsschemarr;rrrrrzs rzcsReZdZdZdZdZdZdZeZe Z e Z fddZ d ddZ fd d ZZS) DefaultRouterz The default router extends the SimpleRouter, but also adds in a default API root view, and adds format suffix patterns to the URLs. Tzapi-rootNcs8d|vr|d|_n ttj|_tj|i|dS)Nroot_renderers)poprr9r ZDEFAULT_RENDERER_CLASSESrIr%)r$r|rdrJrrr%;s zDefaultRouter.__init__cCsBt}|jdj}|jD]\}}}|j|d||<q|jj|dS)z+ Return a basic root view. rrs)r)rr^rr"rnrzru)r$api_urlsrZ list_namer+r,r-rrrget_api_root_viewBs  zDefaultRouter.get_api_root_viewcsHt}|jr6|j|d}td||jd}|||jrDt|}|S)z Generate the list of URL patterns, including a default root view for the API, and appending `.json` style format suffixes. )rz^$rt) rIr2include_root_viewrrroot_view_namer)include_format_suffixesr )r$r3rxZroot_urlrJrrr2Ms   zDefaultRouter.get_urls)N)r4r5r6rrrrZdefault_schema_renderersrzr Z APISchemaViewr r%rr2ryrrrJrr.s  r)!rr collectionsrrZdjango.core.exceptionsrZ django.urlsrrZrest_frameworkrZrest_framework.responserZrest_framework.reverser Zrest_framework.schemasr Zrest_framework.schemas.viewsr Zrest_framework.settingsr Zrest_framework.urlpatternsr rrrr r!r8ZAPIViewrzrrrrrs(        !@