Edit File: inspection.cpython-311.pyc
� u�d� � �V � d Z ddlmZ ddlmZ ej e� � Zd d�Zd� Zd� Z dS ) a# 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`, :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)�utilTc �� � t | � � }|j D ]/}|t v r$t | }|du r| c S || � � }|� n�0dx}}|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 �L/opt/cloudlinux/venv/lib64/python3.11/site-packages/sqlalchemy/inspection.py�inspectr ' s� � �& ��M�M�E��}� � �� �+� � � �c�"�C��d�{�{� �����#�g�,�,�C���������c�� �S�[�C�K��'� .�05� 6� � � � �J� c � � � � fd�}|S )Nc �\ �� �D ]'}|t v rt d|z � � �| t |< �(| S )Nz Type %s is already registered)r �AssertionError)� fn_or_clsr �typess �r �decoratez_inspects.<locals>.decorateO sL �� �� +� +�E�� �#�#�$�6��>�� � � "+�K�� � ��r � )r r s ` r � _inspectsr N s# �� �� � � � � �Or c �6 � t | � � d� � | S )NT)r )r s r �_self_inspectsr [ s � ��I�c�N�N�4���� �Jr N)T) �__doc__� r r � defaultdict�listr r r r r r r �<module>r! s� ��� �0 � � � � � � � � � � � � �d� �t�$�$� �$� $� $� $�N � � �� � � � r