glddlZddlmZmZmZddlmZddlmZGdde Z Gdd e e Z Gd d e e Zd ZdZddZdS)N)ABCMetaabstractpropertyabstractmethod)indent) propertydocceZdZdZdS)RecursiveFactorz5Raised when a factor is ultimately composed of itselfN)__name__ __module__ __qualname____doc__O/granary/edev/quantum/lib/python3.11/site-packages/postgresql/python/element.pyr r s88rr ceZdZdZeedefdZeeddZe dee fgfdZ dS) Elementa# The purpose of an element is to provide a general mechanism for specifying the factors that composed an object. Factors are designated using an ordered set of strings referencing those significant attributes on the object. Factors are important for PG-API as it provides the foundation for collecting the information about the state of the interface that ultimately led up to an error. Traceback: ... postgresql.exceptions.*: CODE: XX000 CURSOR: parameters: (p1, p2, ...) STATEMENT: ... string: SYMBOL: get_types LIBRARY: catalog ... CONNECTION: CONNECTOR: [Host] IRI: pq://user@localhost:5432/database DRIVER: postgresql.driver.pq3 returncdS)z Single-word string describing the kind of element. For instance, `postgresql.api.Statement`'s _e_label is 'STATEMENT'. Usually, this is set directly on the class itself, and is a shorter version of the class's name. Nrselfs r_e_labelzElement._e_label+rrcdS)z The attribute names of the objects that contributed to the creation of this object. The ordering is significant. The first factor is the prime factor. Nrrs r _e_factorszElement._e_factors7rrcdS)a Return an iterable to key-value pairs that provide useful descriptive information about an attribute. Factors on metas are not checked. They are expected to be primitives. If there are no metas, the str() of the object will be used to represent it. Nrrs r_e_metaszElement._e_metasArrN)rr) r r r rrrstrrrrobjectrrrrrr s:s++ f    .   rr) metaclassc$eZdZdZdZdZdZdZdS) ElementSetao An ElementSet is a set of Elements that can be used as an individual factor. In situations where a single factor is composed of multiple elements where each has no significance over the other, this Element can be used represent that fact. Importantly, it provides the set metadata so that the appropriate information will be produced in element tracebacks. SETrc#hKdt|fV|D]}dVdt|fVdS)N)Nz--)lenformat_element)rxs rrzElementSet._e_metas\s^ s4yy ##a  q!! """""##rN)r r r rrr __slots__rrrrr"r"Ms>    #####rr"cjt|dd}|r|dt||ddfSdS)z:get the primary factor on the `obj`, returns None if none.rNr)getattr)objfs r prime_factorr-bsD S,%%( 1wsAaD$'' ''((rc#Kt|f}t|dd}|sdS|d}t||d}||vrt||||||fV|]t|dd}|d}t||d}||vrt||||||fV|[dSdS)zB Yield out the sequence of primary factors of the given object. rNr)setr*r add)r+visitedeffnes r prime_factorsr5hs v;; c<&&  &e S"dLLQQ 1u}sL$''" !u" aT!'\\ a   ++a... A+++ }}}}}rrc||vrt|||fz}t|ts|dSt|Sd}g}|D]\}}d}|d}nt|}d}|E||dzz }t |dkst j|vrt j}t|}nd}d}||| zz }| |g} |j d dD]} d}t|| } || dzz }t| | }t |dkst j|vr |t jt|zz }n|d|zz }| |t j|} t j| } | rt| } | rt| } | | z}|durd|z}nt j|z}|jdz| z}t#|}||\}}t|| }t|d dd}nH|dz }t |dkst j|vrt jt|z}n|dz }|t j|z|zz }|S) zMformat the given element with its factors and metadata into a readable stringNNoneF :FTr)coverager)r isinstancerrrr%oslineseprrstripappendrr*r&joinlstriprr-)r+r<noleadmetaskeyvalmsvalprefactorsattr,mtxtftxtspf factor_nameprimefactors rr&r&s8OO!!! v 3  [ & S/  XS#![ 44 c((4 #_c >1 4yy2~~t++ *C $<abcrrrstringrdecorlibr Exceptionr rrr/r"r-r5r&rrrrXs 9999999999!!!!!!i>>>>>f'>>>>@#########*((( 0Q Q Q Q Q Q r