U ڲg'@s6dZddlmZddlmZddlmZddlmZ ddl m Z m Z ddl mZdd ZGd d d e jZGd d d e jeZGddde jeZGddde jeZGddde jeZGddde jeZGddde je jeZGddde je jeZGddde je jeZGddde je je jeZdS)z7 Generic views that provide commonly needed behaviour. )ValidationError)QuerySet)Http404)get_object_or_404)mixinsviews) api_settingsc Os6zt|f||WStttfk r0tYnXdS)z Same as Django's standard shortcut, but make sure to also raise 404 if the filter_kwargs don't match the required types. N)_get_object_or_404 TypeError ValueErrorrr)querysetZ filter_args filter_kwargsr;/tmp/pip-unpacked-wheel-11h17kvo/rest_framework/generics.pyr src@seZdZdZdZdZdZdZej Z ej Z ddZ ddZdd Zd d Zd d ZddZddZeddZddZddZdS)GenericAPIViewz1 Base class for all other generic views. NpkcOs|SNr)clsargskwargsrrr__class_getitem__1sz GenericAPIView.__class_getitem__cCs6|jdk std|jj|j}t|tr2|}|S)a, Get the list of items for this view. This must be an iterable, and may be a queryset. Defaults to using `self.queryset`. This method should always be used rather than accessing `self.queryset` directly, as `self.queryset` gets evaluated only once, and those results are cached for all subsequent requests. You may want to override this if you need to provide different querysets depending on the incoming request. (Eg. return a list of items that is specific to the user) Nz['%s' should either include a `queryset` attribute, or override the `get_queryset()` method.)r AssertionError __class____name__ isinstancerallselfr rrr get_queryset4s  zGenericAPIView.get_querysetcCsf||}|jp|j}||jks8td|jj|f|j|j|i}t|f|}| |j ||S)z Returns the object the view is displaying. You may want to override this if you need to provide non-standard queryset lookups. Eg if objects are referenced using multiple keyword arguments in the url conf. zExpected view %s to be called with a URL keyword argument named "%s". Fix your URL conf, or set the `.lookup_field` attribute on the view correctly.) filter_querysetrlookup_url_kwarg lookup_fieldrrrrrZcheck_object_permissionsrequest)rr r r objrrr get_objectOs    zGenericAPIView.get_objectcOs"|}|d||||S)z Return the serializer instance that should be used for validating and deserializing input, and for serializing output. context)get_serializer_class setdefaultget_serializer_context)rrrserializer_classrrrget_serializerkszGenericAPIView.get_serializercCs |jdk std|jj|jS)a? Return the class to use for the serializer. Defaults to using `self.serializer_class`. You may want to override this if you need to provide different serializations depending on the incoming request. (Eg. admins get full serialization, others get basic serialization) Nzk'%s' should either include a `serializer_class` attribute, or override the `get_serializer_class()` method.)r)rrrrrrrr&ts z#GenericAPIView.get_serializer_classcCs|j|j|dS)zA Extra context provided to the serializer class. )r"formatview)r"Z format_kwargr+rrrr(sz%GenericAPIView.get_serializer_contextcCs&t|jD]}||j||}q |S)aW Given a queryset, filter it with whichever filter backend is in use. You are unlikely to want to override this method, although you may need to call it either from a list view, or from a custom `get_object` method if you want to apply the configured filtering backend to the default queryset. )listfilter_backendsrr")rr backendrrrrs zGenericAPIView.filter_querysetcCs,t|ds&|jdkrd|_n ||_|jS)zM The paginator instance associated with the view, or `None`. _paginatorN)hasattrpagination_classr1r+rrr paginators    zGenericAPIView.paginatorcCs"|jdkrdS|jj||j|dS)zW Return a single page of results, or `None` if pagination is disabled. N)r-)r4paginate_querysetr"rrrrr5s z GenericAPIView.paginate_querysetcCs|jdk st|j|S)zW Return a paginated style `Response` object for the given output data. N)r4rget_paginated_response)rdatarrrr6sz%GenericAPIView.get_paginated_response)r __module__ __qualname____doc__r r)r!r rZDEFAULT_FILTER_BACKENDSr/ZDEFAULT_PAGINATION_CLASSr3rrr$r*r&r(rpropertyr4r5r6rrrrrs$     rc@seZdZdZddZdS) CreateAPIViewz6 Concrete view for creating a model instance. cOs|j|f||Srcreaterr"rrrrrpostszCreateAPIView.postN)rr8r9r:r@rrrrr<sr<c@seZdZdZddZdS) ListAPIViewz/ Concrete view for listing a queryset. cOs|j|f||Srr.r?rrrgetszListAPIView.getNrr8r9r:rCrrrrrAsrAc@seZdZdZddZdS)RetrieveAPIViewz8 Concrete view for retrieving a model instance. cOs|j|f||Srretriever?rrrrCszRetrieveAPIView.getNrDrrrrrEsrEc@seZdZdZddZdS)DestroyAPIViewz6 Concrete view for deleting a model instance. cOs|j|f||Srdestroyr?rrrdeleteszDestroyAPIView.deleteN)rr8r9r:rKrrrrrHsrHc@s eZdZdZddZddZdS) UpdateAPIViewz6 Concrete view for updating a model instance. cOs|j|f||Srupdater?rrrputszUpdateAPIView.putcOs|j|f||SrZpartial_updater?rrrpatchszUpdateAPIView.patchN)rr8r9r:rOrQrrrrrLsrLc@s eZdZdZddZddZdS)ListCreateAPIViewzL Concrete view for listing a queryset or creating a model instance. cOs|j|f||SrrBr?rrrrCszListCreateAPIView.getcOs|j|f||Srr=r?rrrr@szListCreateAPIView.postN)rr8r9r:rCr@rrrrrRsrRc@s(eZdZdZddZddZddZdS) RetrieveUpdateAPIViewzB Concrete view for retrieving, updating a model instance. cOs|j|f||SrrFr?rrrrCszRetrieveUpdateAPIView.getcOs|j|f||SrrMr?rrrrOszRetrieveUpdateAPIView.putcOs|j|f||SrrPr?rrrrQszRetrieveUpdateAPIView.patchN)rr8r9r:rCrOrQrrrrrSsrSc@s eZdZdZddZddZdS)RetrieveDestroyAPIViewzD Concrete view for retrieving or deleting a model instance. cOs|j|f||SrrFr?rrrrCszRetrieveDestroyAPIView.getcOs|j|f||SrrIr?rrrrKszRetrieveDestroyAPIView.deleteN)rr8r9r:rCrKrrrrrT srTc@s0eZdZdZddZddZddZdd Zd S) RetrieveUpdateDestroyAPIViewzN Concrete view for retrieving, updating or deleting a model instance. cOs|j|f||SrrFr?rrrrCsz RetrieveUpdateDestroyAPIView.getcOs|j|f||SrrMr?rrrrO sz RetrieveUpdateDestroyAPIView.putcOs|j|f||SrrPr?rrrrQ#sz"RetrieveUpdateDestroyAPIView.patchcOs|j|f||SrrIr?rrrrK&sz#RetrieveUpdateDestroyAPIView.deleteN)rr8r9r:rCrOrQrKrrrrrUs rUN)r:Zdjango.core.exceptionsrZdjango.db.models.queryrZ django.httprZdjango.shortcutsrr Zrest_frameworkrrZrest_framework.settingsrZAPIViewrZCreateModelMixinr<ZListModelMixinrAZRetrieveModelMixinrEZDestroyModelMixinrHZUpdateModelMixinrLrRrSrTrUrrrrsR      %