Repository URL to install this package:
|
Version:
3.4.51 ▾
|
ó
EYc @ 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( ( sJ /home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/inspection.pyt inspect&