
    +h                     X    d Z ddlmZ ddlmZ  ej                  e      ZddZd Zd Z	y)	a7  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.

   )exc)utilc                     t        |       }|j                  D ](  }|t        v st        |   }|du r| c S  ||       }|( n dx}}|r||t        j                  d|z        |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:`_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.

    TNz7No inspection system is available for object of type %s)type__mro___registrarsr   NoInspectionAvailable)subjectraiseerrtype_clsregrets         H/var/www/html/venv/lib/python3.12/site-packages/sqlalchemy/inspection.pyinspectr   '   s    & ME}} 	+c"Cd{g,C	 cS[CK''.056
 	
 J    c                        fd}|S )Nc                 T    D ]!  }|t         v rt        d|z        | t         |<   # | S )NzType %s is already registered)r   AssertionError)	fn_or_clsr   typess     r   decoratez_inspects.<locals>.decorateO   sC     	+E#$6>  "+K	+ r    )r   r   s   ` r   	_inspectsr   N   s     Or   c                 (     t        |       d       | S )NT)r   )r   s    r   _self_inspectsr   [   s    IcN4Jr   N)T)
__doc__ r   r   defaultdictlistr   r   r   r   r   r   r   <module>r!      s6   0   dt$$N
r   