Nwgc62dZddlZddlmZddlmZddlmZmZm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZdd lmZed gdZedgdZdZdZGddZGddeZGdde j<ZGddeZ y)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 DynamicRouterrrrcF|jddjddS)zK Double brackets in regex of url_path for escape string formatting {z{{}z}})replace)url_paths M/var/www/horilla/myenv/lib/python3.12/site-packages/rest_framework/routers.pyescape_curly_bracketsr"s$   C & . .sD 99c&tj|S)zX Takes an iterable of iterables, returns a single iterable containing all items ) itertoolschain) list_of_listss rflattenr$)s ??M **rc<eZdZdZddZdZdZdZedZ y) BaseRoutercg|_yN)registryselfs r__init__zBaseRouter.__init__1s  rNc||j|}|j|rd|d|d}t||jj |||ft |dr|`yy)NzRouter with basename "zG" is already registered. Please provide a unique basename for viewset ""_urls)get_default_basenameis_already_registeredrr)appendhasattrr/)r+prefixviewsetbasenamemsgs rregisterzBaseRouter.register4s|  009H  % %h /+H:6DDK9AOC&s+ + fgx89 4 !  "rc@tfd|jDS)z; Check if `basename` is already registered c30K|] \}}}|k(ywr().0_prefix_viewsetr6 new_basenames r z3BaseRouter.is_already_registered..Gs]0K88|+]s)anyr))r+r?s `rr1z BaseRouter.is_already_registeredCs]t}}]]]rctd)q If `basename` is not specified, attempt to automatically determine it from the viewset. z'get_default_basename must be overriddenNotImplementedError)r+r5s rr0zBaseRouter.get_default_basenameIs ""KLLrctd)zO Return a list of URL patterns, given the registered viewsets. zget_urls must be overriddenrDr*s rget_urlszBaseRouter.get_urlsPs""?@@rc\t|ds|j|_|jS)Nr/)r3rGr/r*s rurlszBaseRouter.urlsVs#tW%DJzzrr() __name__ __module__ __qualname__r,r8r1r0rGpropertyrIr;rrr&r&0s2 ^ MA rr&c eZdZeddddddddi ed d di ed dddddddddi edd di gZdfd ZdZdZdZ dZ ddZ dZ xZ S) SimpleRouterz^{prefix}{trailing_slash}$listcreate)getpostz{basename}-listFsuffixListrz%^{prefix}/{url_path}{trailing_slash}$z{basename}-{url_name}rz#^{prefix}/{lookup}{trailing_slash}$retrieveupdatepartial_updatedestroy)rRputpatchdeletez{basename}-detailTInstancez.^{prefix}/{lookup}/{url_path}{trailing_slash}$cr|rdnd|_||_|rd|_d|_t|_nzd|_d|_t |_g}|jD]I}|j}|ddk(r|d d}|d d k(r|dd }|j|j| K||_t|1y) 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_confrroutesrr2_replacesuperr,)r+rfuse_regex_path_routesroute url_param __class__s rr,zSimpleRouter.__init__s%3c( !XD *2D '$DN!UD */D '!DNG >!II Q<3& )!" IR=C' )#2Iu~~)~<= >"DK rct|dd}|Jd|jjjj S)rCquerysetNz`basename` argument not specified, and could not automatically determine the name from the viewset, as it does not have a `.queryset` attribute.)getattrmodel_meta object_namelower)r+r5rts rr0z!SimpleRouter.get_default_basenamesK 7J5# 8&8 8#~~##//5577rc Ttt|jDcgc]-}t|ts|j j /c}}|j}|Dcgc]}|j|vr |j}}|rd}t|dj|z|Dcgc]}|js|}}|Dcgc]}|jr|} }g} |jD]}t|tr0|jr$| |Dcgc]}|j||c}z } Ct|tr0|js$| | Dcgc]}|j||c}z } | j|| Scc}wcc}wcc}wcc}wcc}wcc}w)z Augment `self.routes` with any dynamically generated routes. Returns a list of the Route namedtuple. zZCannot use the @action decorator on the following methods, as they are existing routes: %sz, )rPr$rk isinstancerrvaluesget_extra_actionsrJrjoinrr_get_dynamic_router2) r+r5rp known_actions extra_actionsaction not_allowedr7detail_actions list_actionsrks r get_routeszSimpleRouter.get_routessW$++%rYcdikpYqemm&:&:&<%rst 113 +8 &-/ OO   >C&sTYY{-C'CD D0=NV &NN-:P6&--P P[[ %E%.5<<P^_f4225&A__E<0P\]f4225&A]] e$  % 5&s OP `]s4F F *!F2FFF FF F%cZ|jj}|j|jt |j }t |jjd||j|jjd|j|j|S)Nz {url_path}z {url_name}r) rcopyrWkwargsrrrrrrrurl_namer)r+rprrrs rrzSimpleRouter._get_dynamic_routes%%**, &--((9 !!,9NN##L&//B<<!   rc^i}|jD]\}}t||s|||<|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. )itemsr3)r+r5 method_map bound_methodsmethodrs rget_method_mapzSimpleRouter.get_method_mapsA  (..0 /NFFw'(. f% /rct|dd}t|ddxs|}d}|js t|dd}|t|d|j}|jj |||S)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_kwargNlookup_value_converterlookup_value_regex) lookup_prefixr lookup_value)rurgrirhformat)r+r5rrrrs rget_lookup_regexzSimpleRouter.get_lookup_regexsw= "7,>EU "7,DdKL  "7,@$B]B]^L!!(('-%)  rc g}|jD]5\}}}|j|}|j|}|D]}|j||j}|s#|j j |||j} |s0|jtur| ddk(r| dd} n| dddk(rd| ddz} |jj} | j||jd |j|fi| } |jj | } |j!|j| | |  8|S) zQ Use the registered viewsets to generate a list of URL patterns. )r4lookuprfrr_rcNz^/rb)r6rr6r)r)rrrrrrrfrjrrrrWras_viewrr2) r+retr4r5r6rrkrprregexrviewrs rrGzSimpleRouter.get_urls sc)-% C %FGX**73F__W-F! C--gu}}E ((!!#'#6#6)~~- 8s?$)!"IErd* #eABi"--224 !! (#ll# 'ww=*=zz((((; 4>>%D>ABC! C % CN r)TT)r`)rJrKrLrrrkr,r0rrrrrG __classcell__rrs@rrOrO]s - # &)  8(   6!)#  % *-  A(  G)FV2 8"H    8-rrOc"eZdZdZdZdZdZdZy) APIRootViewz7 The default basic root view for DefaultRouter TNc i}|jj}|jjD]2\}}|r|dz|z} t |||||j d||<4t|S#t $rYKwxYw)N:r)argsrrequestr)resolver_match namespace api_root_dictrr rRrr )r+rrrrrkeyrs rrRzAPIRootView.getBs**44 !//557 MC$s?X5 "!#!::h/ C } "  s"A33 A?>A?)rJrKrL__doc___ignore_model_permissionsschemarrRr;rrrr:s!% FMrrcPeZdZdZdZdZdZdZeZe Z e Z fdZ ddZ fdZxZS) 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-rootNcd|vr|jd|_nttj|_t ||i|y)Nroot_renderers)poprrPr DEFAULT_RENDERER_CLASSESrmr,)r+rrrrs rr,zDefaultRouter.__init__esB v %"(**-=">D "&|'L'L"MD  $)&)rci}|jdj}|jD]\}}}|j|||<|jj |S)z+ Return a basic root view. rr)r)rkrr)rrr)r+api_urlsr list_namer4r5r6s rget_api_root_viewzDefaultRouter.get_api_root_viewlsl KKN'' )- H %FGX$-$4$4h$4$GM& ! H''m'DDrct|}|jr;|j|}t d||j }|j ||jr t|}|S)z Generate the list of URL patterns, including a default root view for the API, and appending `.json` style format suffixes. )rr`r) rmrGinclude_root_viewrrroot_view_namer2include_format_suffixesr)r+rIrroot_urlrrs rrGzDefaultRouter.get_urlswsf w!  ! !))4)8DB4+>+>?H KK !  ' ')$/D rr()rJrKrLrrrrdefault_schema_renderersrr APISchemaViewr r,rrGrrs@rrrXsE"N#KM%O* Err)!rr! collectionsrdjango.core.exceptionsr django.urlsrrrrest_frameworkrrest_framework.responser rest_framework.reverser rest_framework.schemasr rest_framework.schemas.viewsr rest_framework.settingsr rest_framework.urlpatternsrrrrr$r&rOAPIViewrrr;rrrs"755 ,*230=7NO.*QR :+**ZZ:Zz%--<.L.r