U
    8ÄT_   ã                   @   s€   d Z ddlmZmZmZmZ ddlmZ ddlm	Z	m
Z
 ddlmZ ddd„Zd	d
œdd„Zdd„ Zdd„ Zdd„ Zdd„ ZdS )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.
é    )ÚHttp404ÚHttpResponseÚHttpResponsePermanentRedirectÚHttpResponseRedirect)Úloader)ÚNoReverseMatchÚreverse)ÚPromiseNc                 C   s   t j||| |d�}t|||ƒS )z›
    Return a HttpResponse whose content is filled with the result of calling
    django.template.loader.render_to_string() with the passed arguments.
    )Úusing)r   Zrender_to_stringr   )ÚrequestZtemplate_nameÚcontextÚcontent_typeÚstatusr
   Úcontent© r   ú4/tmp/pip-unpacked-wheel-dv63caxw/django/shortcuts.pyÚrender   s    r   F)Ú	permanentc                O   s    |rt nt}|t| f|ž|ŽƒS )aè  
    Return 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: `urls.reverse()` will be used
          to reverse-resolve the name.

        * A URL, which will be used as-is for the redirect location.

    Issues a temporary redirect by default; pass permanent=True to issue a
    permanent redirect.
    )r   r   Úresolve_url)Útor   ÚargsÚkwargsZredirect_classr   r   r   Úredirect   s    r   c                 C   s   t | dƒr| j ¡ S | S )zÃ
    Return a QuerySet or a Manager.
    Duck typing in action: any class with a `get()` method (for
    get_object_or_404) or a `filter()` method (for get_list_or_404) might do
    the job.
    Ú_default_manager)Úhasattrr   Úall)Úklassr   r   r   Ú_get_queryset,   s    

r   c                 O   st   t | ƒ}t|dƒs6t| tƒr"| jn| jj}td| ƒ‚z|j||ŽW S  |jj	k
rn   t
d|jjj ƒ‚Y nX dS )aX  
    Use get() to return an object, or raise 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.

    Like with QuerySet.get(), MultipleObjectsReturned is raised if more than
    one object is found.
    ÚgetzVFirst argument to get_object_or_404() must be a Model, Manager, or QuerySet, not '%s'.úNo %s matches the given query.N)r   r   Ú
isinstanceÚtypeÚ__name__Ú	__class__Ú
ValueErrorr   ÚmodelZDoesNotExistr   Ú_metaÚobject_name)r   r   r   ÚquerysetÚklass__namer   r   r   Úget_object_or_4049   s    
ÿÿr*   c                 O   s`   t | ƒ}t|dƒs6t| tƒr"| jn| jj}td| ƒ‚t|j||Žƒ}|s\t	d|j
jj ƒ‚|S )z÷
    Use 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.
    ÚfilterzTFirst argument to get_list_or_404() must be a Model, Manager, or QuerySet, not '%s'.r   )r   r   r    r!   r"   r#   r$   Úlistr+   r   r%   r&   r'   )r   r   r   r(   r)   Zobj_listr   r   r   Úget_list_or_404Q   s    
ÿÿr-   c                 O   s‚   t | dƒr|  ¡ S t| tƒr$t| ƒ} t| tƒr<|  d¡r<| S zt| ||d�W S  tk
r|   t| ƒrf‚ d| krxd| krx‚ Y nX | S )aM  
    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: `urls.reverse()` will be used
          to reverse-resolve the name.

        * A URL, which will be returned as-is.
    Úget_absolute_url)z./z../)r   r   ú/Ú.)	r   r.   r    r	   ÚstrÚ
startswithr   r   Úcallable)r   r   r   r   r   r   r   f   s    



r   )NNNN)Ú__doc__Zdjango.httpr   r   r   r   Zdjango.templater   Zdjango.urlsr   r   Zdjango.utils.functionalr	   r   r   r   r*   r-   r   r   r   r   r   Ú<module>   s   
	