o Kic6@sdZddlZddlmZddlmZddlmZmZm 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) namedtuple)ImproperlyConfigured)NoReverseMatchpathre_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}}N)replace)url_pathr`C:\Users\psant\Downloads\Anu Raj Backend\school\venv\Lib\site-packages\rest_framework/routers.pyescape_curly_brackets"srcCs tj|S)zX Takes an iterable of iterables, returns a single iterable containing all items N) itertoolschain)Z list_of_listsrrrflatten)s r c@sBeZdZddZdddZddZdd Zd d Zed d Z dS) BaseRoutercCs g|_dSN)registryselfrrr__init__1s zBaseRouter.__init__NcCs^|dur ||}||rd|d|d}t||j|||ft|dr-|`dSdS)NzRouter with basename "zG" is already registered. Please provide a unique basename for viewset ""_urls)get_default_basenameis_already_registeredrr#appendhasattrr()r%prefixviewsetbasenamemsgrrrregister4s   zBaseRouter.registercstfdd|jDS)z; Check if `basename` is already registered c3s|] \}}}|kVqdSr"r).0_prefixZ_viewsetr/ new_basenamerr Gsz3BaseRouter.is_already_registered..N)anyr#)r%r5rr4rr*Csz BaseRouter.is_already_registeredcCtd)q If `basename` is not specified, attempt to automatically determine it from the viewset. z'get_default_basename must be overriddenNNotImplementedError)r%r.rrrr)IszBaseRouter.get_default_basenamecCr8)zO Return a list of URL patterns, given the registered viewsets. zget_urls must be overriddenNr:r$rrrget_urlsPszBaseRouter.get_urlscCst|ds ||_|jS)Nr()r,r<r(r$rrrurlsVs  zBaseRouter.urlsr") __name__ __module__ __qualname__r&r1r*r)r<propertyr=rrrrr!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)rEputpatchdeletez{basename}-detailTZInstancez.^{prefix}/{lookup}/{url_path}{trailing_slash}$cs|rdnd|_||_|rd|_d|_t|_n8d|_d|_t|_g}|jD]&}|j}|ddkr5|d d}|d d krA|dd }| |j |d q$||_t dS) N/z5(?P<{lookup_prefix}{lookup_url_kwarg}>{lookup_value})z[^/.]+z2<{lookup_value}:{lookup_prefix}{lookup_url_kwarg}>strr^$)r) trailing_slash _use_regex _base_pattern_default_value_patternr _url_confrroutesrr+_replacesuperr&)r%rVZuse_regex_pathZ_routesrouteZ url_param __class__rrr&s&     zSimpleRouter.__init__cCs*t|dd}|dusJd|jjjS)r9querysetNz`basename` argument not specified, and could not automatically determine the name from the viewset, as it does not have a `.queryset` attribute.)getattrmodelZ_metaZ object_namelower)r%r.rarrrr)s z!SimpleRouter.get_default_basenamecsttddjD|}fdd|D}|r&d}t|d|dd|D}dd|D}g}jD]1ttrPjrP|fdd|D7}q9ttrejse|fd d|D7}q9| q9|S) z Augment `self.routes` with any dynamically generated routes. Returns a list of the Route namedtuple. cSs g|] }t|tr|jqSr) isinstancerrvalues)r2r^rrr s z+SimpleRouter.get_routes..csg|] }|jvr|jqSr)r>r2action) known_actionsrrrgs zZCannot use the @action decorator on the following methods, as they are existing routes: %sz, cSsg|]}|jr|qSrrrhrrrrgcSsg|]}|js|qSrrkrhrrrrgrlcg|]}|qSr_get_dynamic_routerhr^r%rrrgcrmrrnrhrprrrgrqN) rCr r[Zget_extra_actionsrjoinrerrr+)r%r.Z extra_actions not_allowedr0Zdetail_actionsZ list_actionsr[r)rjr^r%r get_routess$   zSimpleRouter.get_routescCsL|j}||jt|j}t|jd||j |j d|j |j |dS)Nz {url_path}z {url_name}r) rcopyrJkwargsrrrrrrrurl_namer)r%r^rirrrrrros    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. N)itemsr,)r%r.Z method_mapZ bound_methodsmethodrirrrget_method_maps  zSimpleRouter.get_method_maprPcCsZt|dd}t|ddp |}d}|jst|dd}|dur$t|d|j}|jj|||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 lookup_fieldpklookup_url_kwargNZlookup_value_converterZlookup_value_regex) lookup_prefixr} lookup_value)rbrWrYrXformat)r%r.r~r{r}rrrrget_lookup_regexs  zSimpleRouter.get_lookup_regexc Csg}|jD]u\}}}||}||}|D]c}|||j}|s"q|jj|||jd} |sP|jt ur@| ddkr?| dd} n| dddkrPd| dd} |j } | ||j d |j|fi| } |jj|d } ||j| | | d qq|S) zQ Use the registered viewsets to generate a list of URL patterns. )r-lookuprVrrOrSNz^/rR)r/rr/r)r#rrtrzrrrrVrZrrrurJras_viewrr+) r%retr-r.r/rr[r^rregexrviewrrrrr< s<      #zSimpleRouter.get_urls)TT)rP)r>r?r@rrr[r&r)rtrorzrr< __classcell__rrr_rrB]sR + $ rBc@s$eZdZdZdZdZdZddZdS) APIRootViewz7 The default basic root view for DefaultRouter TNc Osji}|jj}|jD]%\}}|r|d|}zt|||||dd||<Wq ty0Yq wt|S)N:r)argsrvrequestr)Zresolver_match namespace api_root_dictrxr rErr)r%rrrvrrkeyrwrrrrEBs"  zAPIRootView.get)r>r?r@__doc__Z_ignore_model_permissionsZschemarrErrrrr:s  rcsReZdZdZdZdZdZdZeZe 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|_nttj|_tj|i|dS)Nroot_renderers)poprrCr ZDEFAULT_RENDERER_CLASSESr]r&)r%rrvr_rrr&es zDefaultRouter.__init__cCs@i}|jdj}|jD] \}}}|j|d||<q |jj|dS)z+ Return a basic root view. rr)rN)r[rr#rrr)r%api_urlsrZ list_namer-r.r/rrrget_api_root_viewls  zDefaultRouter.get_api_root_viewcsHt}|jr|j|d}td||jd}|||jr"t|}|S)z Generate the list of URL patterns, including a default root view for the API, and appending `.json` style format suffixes. )rrPrN) r]r<include_root_viewrrroot_view_namer+include_format_suffixesr )r%r=rZroot_urlr_rrr<ws   zDefaultRouter.get_urlsr")r>r?r@rrrrZdefault_schema_renderersrr Z APISchemaViewr r&rr<rrrr_rrXs   r)!rr collectionsrZdjango.core.exceptionsrZ django.urlsrrrZrest_frameworkrZrest_framework.responserZrest_framework.reverser Zrest_framework.schemasr Zrest_framework.schemas.viewsr Zrest_framework.settingsr Zrest_framework.urlpatternsr rrrr r!rBZAPIViewrrrrrrs*         -^