File: //opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/inspection.pyc
�
���ec @ sW d Z d d l m Z d d l m Z e j e � Z e d � Z d � Z d � Z
d S( s7 The inspection module provides the :func:`_sa.inspect` function,
which delivers runtime information about a wide variety
of SQLAlchemy objects, both within the Core as well as the
ORM.
The :func:`_sa.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:`_sa.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:`_sa.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:`_reflection.Inspector.from_engine` (deprecated in 1.4),
:func:`.orm.attributes.instance_state`, :func:`_orm.class_mapper`,
and others. The other is that the return value of :func:`_sa.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.
i ( t exc( t utilc 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:`_orm.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:`_reflection.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( ( sF /opt/alt/python27/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( sF /opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/inspection.pyt decorateO s
( ( R R ( ( R sF /opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/inspection.pyt _inspectsN s c C s t | � t � | S( N( R R ( R ( ( sF /opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/inspection.pyt _self_inspects[ s N( t __doc__t R R t defaultdictt listR R R R R ( ( ( sF /opt/alt/python27/lib/python2.7/site-packages/sqlalchemy/inspection.pyt <module> s '