ó
H`¾Tc           @   sM   d  Z  d d l m Z m Z e j e ƒ Z e d „ Z d „  Z	 d „  Z
 d S(   s`  The inspection module provides the :func:`.inspect` function,
which delivers runtime information about a wide variety
of SQLAlchemy objects, both within the Core as well as the
ORM.

The :func:`.inspect` function is the entry point to SQLAlchemy's
public API for viewing the configuration and construction
of in-memory objects.   Depending on the type of object
passed to :func:`.inspect`, the return value will either be
a related object which provides a known interface, or in many
cases it will return the object itself.

The rationale for :func:`.inspect` is twofold.  One is that
it replaces the need to be aware of a large variety of "information
getting" functions in SQLAlchemy, such as :meth:`.Inspector.from_engine`,
:func:`.orm.attributes.instance_state`, :func:`.orm.class_mapper`,
and others.    The other is that the return value of :func:`.inspect`
is guaranteed to obey a documented API, thus allowing third party
tools which build on top of SQLAlchemy configurations to be constructed
in a forwards-compatible way.

.. versionadded:: 0.8 The :func:`.inspect` system is introduced
   as of version 0.8.

i   (   t   utilt   excc         C   s§   t  |  ƒ } x` | j D]K } | t k r t | } | t k rB |  S| |  ƒ } | d k	 ra Pqa q q Wd } } | r£ | d k s | d k r£ t j d | ƒ ‚ n  | S(   s¤  Produce an inspection object for the given target.

    The returned value in some cases may be the
    same object as the one given, such as if a
    :class:`.Mapper` object is passed.   In other
    cases, it will be an instance of the registered
    inspection type for the given object, such as
    if an :class:`.engine.Engine` is passed, an
    :class:`.Inspector` object is returned.

    :param subject: the subject to be inspected.
    :param raiseerr: When ``True``, if the given subject
     does not
     correspond to a known SQLAlchemy inspected type,
     :class:`sqlalchemy.exc.NoInspectionAvailable`
     is raised.  If ``False``, ``None`` is returned.

     s7   No inspection system is available for object of type %sN(   t   typet   __mro__t   _registrarst   Truet   NoneR   t   NoInspectionAvailable(   t   subjectt   raiseerrt   type_t   clst   regt   ret(    (    s[   /var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/inspection.pyt   inspect&   s     

c             s   ‡  f d †  } | S(   Nc            s>   x7 ˆ  D]/ } | t  k r, t d | ƒ ‚ n  |  t  | <q W|  S(   Ns   Type %s is already registered(   R   t   AssertionError(   t	   fn_or_clsR
   (   t   types(    s[   /var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/inspection.pyt   decorateP   s    (    (   R   R   (    (   R   s[   /var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/inspection.pyt	   _inspectsO   s    c         C   s   t  |  ƒ t ƒ |  S(   N(   R   R   (   R   (    (    s[   /var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/inspection.pyt   _self_inspects[   s    N(   t   __doc__t    R    R   t   defaultdictt   listR   R   R   R   R   (    (    (    s[   /var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/inspection.pyt   <module>    s
   )	