Why Gemfury?
Push, build, and install
RubyGems
npm packages
Python packages
Maven artifacts
PHP packages
Go Modules
Debian packages
RPM packages
NuGet packages
doctorondemand / djangorestframework python
Repository URL to install this package:
|
Version:
3.6.4 ▾
|
«¬Y8 ã @ s¨ d Z d d l m Z d d l Z d d l Z d d l m Z m Z d d l m Z d d l
m Z d d l m
Z
d d l m Z d d l m Z d d
l m Z d d l m Z m Z d d l m Z d d
l m Z e d d d d d g Z e d d d d g Z e d d d d g Z d d Z d d Z d d Z Gd d d e! Z" Gd d d e" Z# Gd d d e
j$ Z% Gd! d" d" e# Z& d S)#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
é )Úunicode_literalsN)Ú OrderedDictÚ
namedtuple)Úurl)ÚImproperlyConfigured)Úviews)ÚNoReverseMatch)ÚResponse)Úreverse)ÚSchemaGeneratorÚ
SchemaView)Ú api_settings)Úformat_suffix_patternsÚRouter ÚmappingÚnameÚ
initkwargsÚDynamicDetailRouteÚDynamicListRoutec C s4 d o d | k r0 | j d d j d d } | S)zK
Double brackets in regex of url_path for escape string formatting
Ú{Ú}z{{z}})Úreplace)Úurl_path© r úU/Users/carlton/Documents/Django-Stack/django-rest-framework/rest_framework/routers.pyÚescape_curly_brackets& s r c C s@ | j d d } | } | j d | } | j d | } | S)zs
Partially format a format_string, swapping out any
'{methodname}' or '{methodnamehyphen}' components.
Ú_ú-z {methodname}z{methodnamehyphen})r )Ú
format_stringÚ
methodnameZmethodnamehyphenÚretr r r Úreplace_methodname/ s
r! c C s
t j | S)zX
Takes an iterable of iterables, returns a single iterable containing all items
)Ú itertoolsÚchain)Z
list_of_listsr r r Úflatten; s r$ c @ sU e Z d Z d d Z d d d Z d d Z d d Z e d
d Z d S) Ú
BaseRouterc C s
g | _ d S)N)Úregistry)Úselfr r r Ú__init__C s zBaseRouter.__init__Nc C s8 | d k r | j | } | j j | | | f d S)N)Úget_default_base_namer& Úappend)r' ÚprefixÚviewsetÚ base_namer r r ÚregisterF s zBaseRouter.registerc C s t d d S)zr
If `base_name` is not specified, attempt to automatically determine
it from the viewset.
z(get_default_base_name must be overriddenN)ÚNotImplementedError)r' r, r r r r) K s z BaseRouter.get_default_base_namec C s t d d S)zO
Return a list of URL patterns, given the registered viewsets.
zget_urls must be overriddenN)r/ )r' r r r Úget_urlsR s zBaseRouter.get_urlsc C s% t | d s | j | _ | j S)NÚ_urls)Úhasattrr0 r1 )r' r r r ÚurlsX s zBaseRouter.urls) Ú__name__Ú
__module__Ú __qualname__r( r. r) r0 Úpropertyr3 r r r r r% B s
r% c s e Z d Z e d d d d d d d i d d d
d d i e d d
d d d
i e d d d d d d d d d d d i d d d
d d i e d d d d d
i g Z d f d d Z d d Z d d Z d! d" Z
d# d$ d% Z d& d' Z S)(Ú SimpleRouterr z^{prefix}{trailing_slash}$r ÚgetÚlistÚpostÚcreater z{basename}-listr ÚsuffixÚListz'^{prefix}/{methodname}{trailing_slash}$z {basename}-{methodnamehyphen}z#^{prefix}/{lookup}{trailing_slash}$ÚretrieveÚputÚupdateÚpatchZpartial_updateÚdeleteÚdestroyz{basename}-detailÚInstancez0^{prefix}/{lookup}/{methodname}{trailing_slash}$Tc s, | r d p d | _ t t | j d S)Nú/Ú )Útrailing_slashÚsuperr8 r( )r' rH )Ú __class__r r r( s zSimpleRouter.__init__c C s= t | d d } | d k s* t d | j j j j S)zr
If `base_name` is not specified, attempt to automatically determine
it from the viewset.
ÚquerysetNz`base_name` argument not specified, and could not automatically determine the name from the viewset, as it does not have a `.queryset` attribute.)ÚgetattrÚAssertionErrorÚmodelÚ_metaÚ object_nameÚlower)r' r, rK r r r r) s z"SimpleRouter.get_default_base_namec sc t t d d | j D } g } g } x« t D] } t | } t | d d } t | d d } | r; | | k r t d | d d | D } | rÅ | j | | f q; | j | | f q; W f d d
} g }
xh | j D]] } t | t r)|
| | | 7}
qþ t | t rN|
| | | 7}
qþ |
j | qþ W|
S) z
Augment `self.routes` with any dynamically generated routes.
Returns a list of the Route namedtuple.
c S s. g | ]$ } t | t r | j j q Sr )Ú
isinstancer r Úvalues)Ú.0Úrouter r r ú
<listcomp>¢ s z+SimpleRouter.get_routes.<locals>.<listcomp>Zbind_to_methodsNÚdetailTz\Cannot use @detail_route or @list_route decorators on method "%s" as it is an existing routec S s g | ] } | j q Sr )rQ )rT Úmethodr r r rV ± s c sÞ g } xÑ | D]É \ } t j } | j j } | j | | j d d p\ } t | } | j d d p | } | j t d t | j
| d f d d | D d t | j | d | q
W| S) Nr Úurl_namer r c s i | ] } | q Sr r )rT Z
httpmethod)r r r ú
<dictcomp>Â s zHSimpleRouter.get_routes.<locals>._get_dynamic_routes.<locals>.<dictcomp>r r ) rL Úkwargsr ÚcopyrA Úpopr r* r r! r r )rU Zdynamic_routesr Ú httpmethodsZ
method_kwargsr r rY )r, )r r Ú_get_dynamic_routes· s
z4SimpleRouter.get_routes.<locals>._get_dynamic_routes)
r: r$ ÚroutesÚdirrL r r* rR r r ) r' r, Z
known_actionsZ
detail_routesZ list_routesr Úattrr^ rW r_ r rU r )r, r Ú
get_routes s0 "
zSimpleRouter.get_routesc C s@ i } x3 | j D]% \ } } t | | r | | | <q W| 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.
)Úitemsr2 )r' r, Z
method_mapZ
bound_methodsrX Úactionr r r Úget_method_map× s
zSimpleRouter.get_method_maprG c C s^ d } t | d d } t | d d p- | } t | d d } | j d | d | d | 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
z5(?P<{lookup_prefix}{lookup_url_kwarg}>{lookup_value})Ú lookup_fieldÚpkÚlookup_url_kwargNZlookup_value_regexz[^/.]+Ú
lookup_prefixÚ lookup_value)rL Úformat)r' r, rj Z
base_regexrg ri rk r r r Úget_lookup_regexã s z SimpleRouter.get_lookup_regexc C s g } x| j D]÷ \ } } } | j | } | j | } xÇ | D]¿ } | j | | j } | sh qD | j j d | d | d | j } | r½ | d d
d k r½ d | d d
} | j | | j }
| j
j d | } | j t | |
d | qD Wq W| S)
zQ
Use the registered viewsets to generate a list of URL patterns.
r+ ÚlookuprH Né z^/ú^Úbasenamer ) r& rm rc rf r r rl rH Úas_viewr r r* ) r' r r+ r, rq rn r` rU r ÚregexÚviewr r r r r0 ú s$
$zSimpleRouter.get_urls)
r4 r5 r6 r r r r` r( r) rc rf rm r0 r r )rJ r r8 _ s8
= r8 c @ s4 e Z d Z d Z d Z d Z d Z d d Z d S)Ú APIRootViewz7
The default basic root view for DefaultRouter
TNc O s£ t } | j j } x | j j D]p \ } } | rE | d | } y8 t | d | d | d | d | j d d | | <Wq% t k
r w% Yq% Xq% Wt | S)Nú:Úargsr[ Úrequestrl ) r Úresolver_matchÚ namespaceÚ
api_root_dictrd r
r9 r r )r' rx rw r[ r rz ÚkeyrY r r r r9 ( s
zAPIRootView.get)r4 r5 r6 Ú__doc__Z_ignore_model_permissionsZexclude_from_schemar{ r9 r r r r ru s
ru c s e Z d Z d Z d Z d Z d Z d Z e Z e Z
e Z f d d Z d d d Z
d d d
Z f d d Z S)
Ú
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-rootNc sü d | k r" t j d t d d d | k rF d | k sF t d d | k rj d | k sj t d | j d d | _ | j d d | _ | j d | j | _ d | k rÍ | j d | _ n t
t j | _ t
t | j | | d S) NÚ schema_titlez\Including a schema directly via a router is now deprecated. Use `get_schema_view()` instead.Ú
stacklevelro Úschema_renderersz Missing "schema_title" argument.Ú
schema_urlÚroot_renderers)ÚwarningsÚwarnÚDeprecationWarningrM r] r r Údefault_schema_renderersr r r: r
ÚDEFAULT_RENDERER_CLASSESrI r~ r( )r' rw r[ )rJ r r r( K s
zDefaultRouter.__init__c C s@ | j d | j d | j d | } | j j d | j d | S)z,
Return a schema root view.
Útitler ÚpatternsZrenderer_classesÚschema_generator)r r r Ú
APISchemaViewrr r )r' Úapi_urlsr r r r Úget_schema_root_view` s z"DefaultRouter.get_schema_root_viewc C s_ t } | j d j } x0 | j D]% \ } } } | j d | | | <q# W| j j d | S)z+
Return a basic root view.
r rq r{ )r r` r r& rl ru rr )r' r r{ Z list_namer+ r, rq r r r Úget_api_root_viewo s
z DefaultRouter.get_api_root_viewc s t t | j } | j rs | j r< | j d | } n | j d | } t d | d | j } | j | | j
r t | } | S)z
Generate the list of URL patterns, including a default root view
for the API, and appending `.json` style format suffixes.
r z^$r ) rI r~ r0 Úinclude_root_viewr r r r Úroot_view_namer* Úinclude_format_suffixesr )r' r3 rt Zroot_url)rJ r r r0 z s
zDefaultRouter.get_urls)r4 r5 r6 r} r r r r ru r r r r( r r r0 r r )rJ r r~ > s r~ )'r} Ú
__future__r r" r Ú collectionsr r Údjango.conf.urlsr Údjango.core.exceptionsr Úrest_frameworkr Úrest_framework.compatr Zrest_framework.responser Úrest_framework.reverser
Zrest_framework.schemasr r Úrest_framework.settingsr
Zrest_framework.urlpatternsr r r r r r! r$ Úobjectr% r8 ZAPIViewru r~ r r r r Ú<module> s. Á