Repository URL to install this package:
Version:
4.0.108 ▾
|
ó 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&