o wvXj/@sdZddlZddlmZmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZdd lmZedgdZedgdZddZddZGdddZGdddeZGddde jZ GdddeZ!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)url)ImproperlyConfigured)NoReverseMatch)views)Response)reverse)SchemaGenerator) SchemaView) api_settings)format_suffix_patternsRoutermappingnamedetail initkwargs DynamicRouterrrrcCs|ddddS)zK Double brackets in regex of url_path for escape string formatting {z{{}z}})replace)url_pathrS/var/www/html/myproject/venv/lib/python3.10/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) list_of_listsrrrflatten*s r c@s:eZdZddZd ddZddZdd Zed d ZdS) BaseRoutercCs g|_dSN)registryselfrrr__init__2s zBaseRouter.__init__NcCs:|dur ||}|j|||ft|dr|`dSdSN_urls)get_default_basenamer#appendhasattrr()r%prefixviewsetbasenamerrrregister5s   zBaseRouter.registercCtd)q If `basename` is not specified, attempt to automatically determine it from the viewset. z'get_default_basename must be overriddenNotImplementedError)r%r-rrrr)>szBaseRouter.get_default_basenamecCr0)zO Return a list of URL patterns, given the registered viewsets. zget_urls must be overriddenr2r$rrrget_urlsEszBaseRouter.get_urlscCst|ds ||_|jSr')r+r4r(r$rrrurlsKs  zBaseRouter.urlsr") __name__ __module__ __qualname__r&r/r)r4propertyr5rrrrr!1s  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}$retrieveupdatepartial_updatedestroy)r=putpatchdeletez{basename}-detailTInstancez.^{prefix}/{lookup}/{url_path}{trailing_slash}$cs|rdnd|_tdS)N/)trailing_slashsuperr&)r%rK __class__rrr&szSimpleRouter.__init__cCs*t|dd}|dusJd|jjjS)r1querysetNz`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%r-rOrrrr)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).0routerrr s z+SimpleRouter.get_routes..csg|] }|jvr|jqSr)r6rWaction) known_actionsrrrYs  zZCannot use the @action decorator on the following methods, as they are existing routes: %sz, cSsg|]}|jr|qSrrrZrrrrYcSsg|]}|js|qSrr]rZrrrrYr^cg|]}|qSr_get_dynamic_routerZrXr%rrrYcr_rr`rZrbrrrYrc) r;r routesget_extra_actionsrjoinrUrrr*)r%r- extra_actions not_allowedmsgdetail_actions list_actionsrdr)r\rXr%r get_routess$   zSimpleRouter.get_routescCsL|j}||jt|j}t|jd||j |j d|j |j |dS)Nz {url_path}z {url_name}r) rcopyrBkwargsrrrrrrrurl_namer)r%rXr[rrrrrras    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- method_map bound_methodsmethodr[rrrget_method_maps  zSimpleRouter.get_method_maprJcCs<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_kwargNlookup_value_regexz[^/.]+) lookup_prefixrw lookup_value)rPformat)r%r-ry base_regexrurwrzrrrget_lookup_regexs  zSimpleRouter.get_lookup_regexc Csg}|jD]b\}}}||}||}|D]P}|||j}|s"q|jj|||jd} |s>| dddkr>d| dd} |j } | ||j d|j |fi| } |j j|d} |t| | | dqq|S) zQ Use the registered viewsets to generate a list of URL patterns. )r,lookuprKNz^/^)r.rr.r)r#r}rlrtrrr{rKrrmrBras_viewrr*) r%retr,r-r.r~rdrXrregexrviewrrrrr4s2    zSimpleRouter.get_urls)T)rJ)r6r7r8rrrdr&r)rlrartr}r4 __classcell__rrrMrr:RsR + $ r:c@s$eZdZdZdZdZdZddZdS) APIRootViewz7 The default basic root view for DefaultRouter TNc Osnt}|jj}|jD]&\}}|r|d|}zt|||||ddd||<Wq ty2Yq wt|S)N:r{)argsrnrequestr{) rresolver_match namespace api_root_dictrpr r=rr)r%rrrnrrkeyrorrrr=s"   zAPIRootView.get)r6r7r8__doc___ignore_model_permissionsschemarr=rrrrrs  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)poprr;r DEFAULT_RENDERER_CLASSESrLr&)r%rrnrMrrr&<s zDefaultRouter.__init__cCsBt}|jdj}|jD] \}}}|j|d||<q |jj|dS)z+ Return a basic root view. rr)r)rrdrr#r{rr)r%api_urlsr list_namer,r-r.rrrget_api_root_viewCs  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. )rz^$r) rLr4include_root_viewrrroot_view_namer*include_format_suffixesr )r%r5rroot_urlrMrrr4Ns   zDefaultRouter.get_urlsr")r6r7r8rrrrdefault_schema_renderersrr APISchemaViewr r&rr4rrrrMrr/s   r)"rr collectionsrrdjango.conf.urlsrdjango.core.exceptionsr django.urlsrrest_frameworkrrest_framework.responserrest_framework.reverser rest_framework.schemasr rest_framework.schemas.viewsr rest_framework.settingsr rest_framework.urlpatternsr rrrr r!r:APIViewrrrrrrs,          !@