
u^                  @   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 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   2/tmp/pip-build-8lau8j11/django/django/shortcuts.pyrender   s    r   	permanentFc            O   s(   | r t  n t } | t |  | |   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 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   s   t  |   } t | d  sO t |  t  r3 |  j n	 |  j j } t d |   y | j | |   SWn1 | j j	 k
 r t
 d | j j j   Yn Xd 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'.z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  sO t |  t  r3 |  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'.zNo %s matches the given query.)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 |  j   St |  t  r4 t |   }  t |  t  rV |  j d  rV |  Sy t |  d | d | SWn< t k
 r t |   r   d |  k r d |  k r   Yn 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./../r   r   /.)r.   r/   )	r   r-   r   r	   str
startswithr   r   callable)r   r   r   r   r   r   r   f   s    
r   )__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   "	