_}dgc6NdZddlZddlmZddlmZddlmZmZm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZdd lmZed gdZedgdZdZdZGddZGddeZGdde jZGddeZ 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 DynamicRouterrrrcV|ddddS)zK Double brackets in regex of url_path for escape string formatting {z{{}z}})replace)url_paths U/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/rest_framework/routers.pyescape_curly_bracketsr"s*   C & & . .sD 9 99ctj|S)zX Takes an iterable of iterables, returns a single iterable containing all items ) itertoolschain) list_of_listss rflattenr$)s ?M **rcDeZdZdZddZdZdZdZedZ dS) BaseRoutercg|_dSN)registryselfs r__init__zBaseRouter.__init__1s  rNc|||}||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+prefixviewsetbasenamemsgs rregisterzBaseRouter.register4s  0099H  % %h / / ,OHOODKOOOC&s++ + fgx8999 4 ! !    rcDtfd|jDS)z; Check if `basename` is already registered c3,K|]\}}}|kVdSr().0_prefix_viewsetr6 new_basenames r z3BaseRouter.is_already_registered..Gs/]]0K88|+]]]]]]r)anyr))r+r?s `rr1z BaseRouter.is_already_registeredCs*]]]]t}]]]]]]rc td)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 ""KLLLrc td)zO Return a list of URL patterns, given the registered viewsets. zget_urls must be overriddenrDr*s rget_urlszBaseRouter.get_urlsPs""?@@@rcbt|ds||_|jS)Nr/)r3rGr/r*s rurlszBaseRouter.urlsVs+tW%% )DJzrr() __name__ __module__ __qualname__r,r8r1r0rGpropertyrIr;rrr&r&0s    ^^^ MMMAAA Xrr&c eZdZeddddddddi ed d di ed dddddddddi edd di gZdfd ZdZdZdZ dZ d dZ 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}$c|rdnd|_||_|rd|_d|_t|_nd|_d|_t |_g}|jD]^}|j}|ddkr |d d}|d d kr |dd }| | | _||_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_confrroutesrr2_replacesuperr,)r+rfuse_regex_path_routesroute url_param __class__s rr,zSimpleRouter.__init__s%3;cc(  "!XD *2D '$DNN!UD */D '!DNG > >!I Q<3&& )!"" IR=C'' )#2#Iu~~)~<<====!DK rct|dd}| Jd|jjjS)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_basenamesH 7J55##&8###~#/55777rc& ttdjD|}fd|D}|r'd}t |d|zd|D}d|D}g}jD]u t tr jr| fd|Dz }1t tr js| fd|Dz }`| v|S) z Augment `self.routes` with any dynamically generated routes. Returns a list of the Route namedtuple. cjg|]0}t|t|j1Sr;) isinstancerrvalues)r<rps r z+SimpleRouter.get_routes..s8%r%r%rYcdikpYqYq%rem&:&:&<&<%r%r%rrc0g|]}|jv |jSr;)rJ)r<action known_actionss rr~z+SimpleRouter.get_routes..s2   &-// O///rzZCannot use the @action decorator on the following methods, as they are existing routes: %sz, c g|] }|j | Sr;rr<rs rr~z+SimpleRouter.get_routes..sNNNV N&NNNrc g|] }|j | Sr;rrs rr~z+SimpleRouter.get_routes..sPPP6&-PPPPrc<g|]}|Sr;_get_dynamic_router<rrpr+s rr~z+SimpleRouter.get_routes..s)___f4225&AA___rc<g|]}|Sr;rrs rr~z+SimpleRouter.get_routes..s)]]]f4225&AA]]]r) rPr$rkget_extra_actionsrjoinr|rrr2) r+r5 extra_actions not_allowedr7detail_actions list_actionsrkrrps ` @@r get_routeszSimpleRouter.get_routesspW%r%r$+%r%r%rsstt 1133     *7     E>C&sTYY{-C-C'CDD DON}NNNPP]PPP [ % %E%.. %5< %_____P^____E<00 % %]]]]]P\]]]] e$$$$ rc:|j}||jt |j}t |jd||j |j d|j |j |S)Nz {url_path}z {url_name}r) rcopyrWkwargsrrrrrrrurl_namer)r+rprrrs rrzSimpleRouter._get_dynamic_routes%**,, &-((((99 !!,99N##L&/BB<!     rchi}|D]\}}t||r|||<|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_mapsK  (..00 / /NFFw'' /(. f%rr`ct|dd}t|ddp|}d}|jst|dd}|t|d|j}|j|||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,>EEU  L"7,DdKKL  "7,@$B]^^L!(('-%)   rc g}|jD]D\}}}||}||}|D]}|||j}|s!|j|||j} |s@|jtur| ddkr | dd} n| dddkr d| ddz} |j } | ||j d |j|fi| } |j| } ||| | | F|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 s)-% C% C %FGX**733F__W--F! C! C--gu}EE ((!!#'#6)0~-- 8s??$)!""IErrd** #eABBi"-2244 !! (#l## 'ww==*==z((((;; 4>>%D>AABBBBC! CF r)TT)r`)rJrKrLrrrkr,r0rrrrrG __classcell__rrs@rrOrO]sb - # &)   8(     6!)#  % *-   A(    G)FV2 8 8 8"""H           8-------rrOc$eZdZdZdZdZdZdZdS) APIRootViewz7 The default basic root view for DefaultRouter TNc i}|jj}|jD]J\}}|r|dz|z} t |||||d||<;#t $rYGwxYwt|S)N:r)argsrrequestr)resolver_match namespace api_root_dictrr rRrr )r+rrrrrkeyrs rrRzAPIRootView.getBs*4 !/5577  MC 6$s?X5 "!#!::h// C"    }}s*A## A0/A0)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|d|_nttj|_t j|i|dS)Nroot_renderers)poprrPr DEFAULT_RENDERER_CLASSESrmr,)r+rrrrs rr,zDefaultRouter.__init__es[ v % %"(**-=">">D  "&|'L"M"MD $)&)))))rci}|jdj}|jD]\}}}||||< |j|S)z+ Return a basic root view. rr)r)rkrr)rrr)r+api_urlsr list_namer4r5r6s rget_api_root_viewzDefaultRouter.get_api_root_viewlsi KN' )- H H %FGX$-$4$4h$4$G$GM& ! !''m'DDDrct}|jrB||}t d||j}|||jrt|}|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_urlsws ww!!  ! "))4)88DB4+>???H KK ! ! !  ' 0)$//D rr()rJrKrLrrrrdefault_schema_renderersrr APISchemaViewr r,rrGrrs@rrrXs"N#KM%O***** E E E 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""""""7777775555555555 ,,,,,,******222222333333000000====== 7NNNOOz.*Q*Q*QRR :::+++********ZZZZZZ:ZZZz%-<.....L.....r