B
    þ¦†\®  ã               @   sD   d Z ddlmZ ddlmZ e e¡Zddd„Zdd„ Zd	d
„ Z	dS )a	  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.

é   )Úexc)ÚutilTc             C   st   t | ƒ}xD|jD ]2}|tkrt| }|dkr0| S || ƒ}|dk	rP qW d }}|rp|dksb|dkrpt d| ¡‚|S )a¤  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.

     TNz7No inspection system is available for object of type %s)ÚtypeÚ__mro__Ú_registrarsr   ZNoInspectionAvailable)ZsubjectZraiseerrÚtype_ÚclsZregZret© r	   ú4lib/python3.7/site-packages/sqlalchemy/inspection.pyÚinspect&   s    r   c                 s   ‡ fdd„}|S )Nc                s.   x(ˆ D ] }|t krtd| ƒ‚| t |< qW | S )NzType %s is already registered)r   ÚAssertionError)Z	fn_or_clsr   )Útypesr	   r
   ÚdecorateN   s    

z_inspects.<locals>.decorater	   )r   r   r	   )r   r
   Ú	_inspectsM   s    	r   c             C   s   t | ƒdƒ | S )NT)r   )r   r	   r	   r
   Ú_self_inspectsZ   s    r   N)T)
Ú__doc__Ú r   r   ÚdefaultdictÚlistr   r   r   r   r	   r	   r	   r
   Ú<module>   s   

'