î _ÝVã @s{dZddlZddlmZddlmZddlmZddlm Z ddl m Z m Z m Z mZddlmZmZdd lmZdd lmZmZmZdd lmZdd lmZdd lmZddlmZdeddeeddd„Z deddeeeddd„Z!dd„Z"dd„Z#dd„Z$dd„Z%dd„Z&dS)zµ This module collects helper functions and classes that "span" multiple levels of MVC. In other words, these functions/classes introduce controlled coupling for convenience's sake. éN)Ú urlresolvers)Ú ModelBase)ÚManager)ÚQuerySet)ÚHttp404Ú HttpResponseÚHttpResponsePermanentRedirectÚHttpResponseRedirect)ÚRequestContextÚloader)Ú_current_app_undefined)Ú_context_instance_undefinedÚ_dictionary_undefinedÚ_dirs_undefined)Úsix)ÚRemovedInDjango110Warning)Ú force_text)ÚPromisec Csp|tkr?|tkr?|tkr?tj||d|ƒ}n!tj|||||d|ƒ}t|||ƒS)zœ Returns a HttpResponse whose content is filled with the result of calling django.template.loader.render_to_string() with the passed arguments. Úusing)r rrr Úrender_to_stringr) Ú template_nameÚcontextÚcontext_instanceÚ content_typeÚstatusÚdirsÚ dictionaryrÚcontent©rú2/tmp/pip-build-ghmbqnp_/Django/django/shortcuts.pyÚrender_to_responses    r c Csï|tkrQ|tkrQ|tkrQ|tkrQtj||d|d| ƒ} nŽ|tk r{|tk r¾tdƒ‚q¾nCt|ƒ}|tk r¾tj dt ddƒ||_ ||_ ntj|||||d| ƒ} t | ||ƒS)z Returns a HttpResponse whose content is filled with the result of calling django.template.loader.render_to_string() with the passed arguments. Uses a RequestContext by default. ÚrequestrzVIf you provide a context_instance you must set its current_app before calling render()zcThe current_app argument of render is deprecated. Set the current_app attribute of request instead.Ú stacklevelé)r r rrr rÚ ValueErrorr ÚwarningsÚwarnrÚ current_appZ _current_appr) r!rrrrrr'rrrrrrrÚrender2s(            r(cOs7|jddƒrt}nt}|t|||ŽƒS)að Returns an HttpResponseRedirect to the appropriate URL for the arguments passed. The arguments could be: * A model: the model's `get_absolute_url()` function will be called. * A view name, possibly with arguments: `urlresolvers.reverse()` will be used to reverse-resolve the name. * A URL, which will be used as-is for the redirect location. By default issues a temporary redirect; pass permanent=True to issue a permanent redirect Z permanentF)Úpoprr Ú resolve_url)ÚtoÚargsÚkwargsZredirect_classrrrÚredirect^s r.cCs‡t|tƒr|St|tƒr+|}nRt|tƒrF|j}n7t|tƒra|j}n |jj}td|ƒ‚|j ƒS)zÌ Returns a QuerySet from a Model, Manager, or QuerySet. Created to make get_object_or_404 and get_list_or_404 more DRY. Raises a ValueError if klass is not a Model, Manager, or QuerySet. zHObject is of type '%s', but must be a Django Model, Manager, or QuerySet) Ú isinstancerrrZ_default_managerÚtypeÚ__name__Ú __class__r$Úall)ÚklassÚmanagerZ klass__namerrrÚ _get_querysetws     r6c OsXt|ƒ}y|j||ŽSWn1|jjk rStd|jjjƒ‚YnXdS)a_ Uses get() to return an object, or raises a Http404 exception if the object does not exist. klass may be a Model, Manager, or QuerySet object. All other passed arguments and keyword arguments are used in the get() query. Note: Like with get(), an MultipleObjectsReturned will be raised if more than one object is found. zNo %s matches the given query.N)r6ÚgetÚmodelZ DoesNotExistrÚ_metaÚ object_name)r4r,r-ÚquerysetrrrÚget_object_or_404Žs r<cOsJt|ƒ}t|j||Žƒ}|sFtd|jjjƒ‚n|S)zø Uses filter() to return a list of objects, or raise a Http404 exception if the list is empty. klass may be a Model, Manager, or QuerySet object. All other passed arguments and keyword arguments are used in the filter() query. zNo %s matches the given query.)r6ÚlistÚfilterrr8r9r:)r4r,r-r;Zobj_listrrrÚget_list_or_404 s  r?c OsÈt|dƒr|jƒSt|tƒr7t|ƒ}nt|tjƒr_|jdƒr_|Snytj |d|d|ƒSWnEtj k rÃt |ƒr¡‚nd|kr¿d|kr¿‚nYnX|S) aU Return a URL appropriate for the arguments passed. The arguments could be: * A model: the model's `get_absolute_url()` function will be called. * A view name, possibly with arguments: `urlresolvers.reverse()` will be used to reverse-resolve the name. * A URL, which will be returned as-is. Úget_absolute_urlú./ú../r,r-ú/Ú.)rArB) Úhasattrr@r/rrrÚ string_typesÚ startswithrÚreverseZNoReverseMatchÚcallable)r+r,r-rrrr*¯s   r*)'Ú__doc__r%Z django.corerZdjango.db.models.baserZdjango.db.models.managerrZdjango.db.models.queryrZ django.httprrrr Zdjango.templater r Zdjango.template.contextr Zdjango.template.enginer rrZ django.utilsrZdjango.utils.deprecationrZdjango.utils.encodingrZdjango.utils.functionalrr r(r.r6r<r?r*rrrrÚs6 "  (