
    +h3                     b   d Z ddlZddlmZ ddlmZ ddlmZ ddlmZ ddl	m
Z
 d	d
lmZ d	dlmZ d	dlm	Z	 d	dlmZ  e       Zd Zd Zd Z G d de      Z G d de      Z G d de      Z G d de      Z  ej2                  e      d         G d de      Zd Z G d de      Zdad Zy) zRoutines to handle the string class registry used by declarative.

This system allows specification of classes and expressions used in
:func:`_orm.relationship` using strings.

    N   )
attributes)
interfaces)SynonymProperty)ColumnProperty)class_mapper   )exc)
inspection)util)_get_table_keyc                    | |v r(||    }t        |t              st        ||g      x}|| <   n||| <   	 |d   }|j                  j                  d      }|rP|j                  d      }|j                  |      }|D ]  }|j                  |      } |j                  | |       |rOyy# t        $ r t        dd      x|d<   }Y w xY w)z^Add a class to the _decl_class_registry associated with the
    given declarative class.

    _sa_module_registryN.r   )	
isinstance_MultipleClassMarkerKeyError_ModuleMarker
__module__splitpop
get_module	add_class	classnameclsdecl_class_registryexistingroot_moduletokenstokenmodules           M/var/www/html/venv/lib/python3.12/site-packages/sqlalchemy/orm/clsregistry.pyr   r       s    
 ''&y1($898Lh9 H*95 *-I&E)*?@ ^^!!#&F 

1''. 	.E&&u-F	.C(   E ((=tD	E!	
Es   B& &CCc                 d   | |v r*||    }t        |t              r|j                  |       n|| = 	 |d   }|j                  j                  d      }|rP|j                  d      }|j                  |      }|D ]  }|j                  |      } |j                  | |       |rOy y # t        $ r Y y w xY w)Nr   r   r   )	r   r   remove_itemr   r   r   r   r   remove_classr   s           r#   r&   r&   H   s    ''&y1h 45  %#I.)*?@ ^^!!#&F


1''. 	.E&&u-F	.Is+   s   B# #	B/.B/c                     | |vry||    }t        |t              r|j                  D ]  } ||      s y y ||       S )a  test if a key is empty of a certain object.

    used for unit tests against the registry to see if garbage collection
    is working.

    "test" is a callable that will be passed an object should return True
    if the given object is the one we were looking for.

    We can't pass the actual object itself b.c. this is for testing garbage
    collection; the caller will have to have removed references to the
    object itself.

    TFN)r   r   contents)keyr   testthing	sub_things        r#   _key_is_emptyr-   _   sP     %%$E%-. 	II	 ;    c                   :    e Zd ZdZdZd
dZd Zd Zd Zd Z	d	 Z
y)r   zRrefers to multiple classes of the same name
    within _decl_class_registry.

    )	on_remover(   __weakref__Nc           	          || _         t        |D cg c]"  }t        j                  || j                        $ c}      | _        t        j                  |        y c c}w N)r0   setweakrefref_remove_itemr(   _registriesadd)selfclassesr0   items       r#   __init__z_MultipleClassMarker.__init__   sH    ">EFdW[[t001F
 	 Gs   'Ac                 L    | j                  t        j                  |             y r3   )r7   r5   r6   r:   r   s     r#   r%   z _MultipleClassMarker.remove_item   s    '++c*+r.   c                 (    d | j                   D        S )Nc              3   *   K   | ]  } |         y wr3    ).0r6   s     r#   	<genexpr>z0_MultipleClassMarker.__iter__.<locals>.<genexpr>   s     /#/s   r(   )r:   s    r#   __iter__z_MultipleClassMarker.__iter__   s    ///r.   c                     t        | j                        dkD  r+t        j                  ddj	                  ||gz         z        t        | j                        d   } |       }|t        |      |S )Nr   zxMultiple classes found for path "%s" in the registry of this declarative base. Please use a fully module-qualified path.r   r   )lenr(   r
   InvalidRequestErrorjoinlist	NameError)r:   pathr)   r6   r   s        r#   attempt_getz _MultipleClassMarker.attempt_get   su    t}}!))B 88DC5L)+  t}}%a(C%C{n$Jr.   c                     | j                   j                  |       | j                   s3t        j                  |        | j                  r| j                          y y y r3   )r(   discardr8   r0   )r:   r6   s     r#   r7   z!_MultipleClassMarker._remove_item   sD    c"}}%~~   r.   c                    t        | j                  D cg c]	  } |        c}D cg c]  }||j                   c}      }|j                  |v r0t        j                  d|j                  d|j
                  d       | j                  j                  t        j                  || j                               y c c}w c c}w )Nz[This declarative base already contains a class with the same class name and module name as r   z2, and will be replaced in the string-lookup table.)
r4   r(   r   r   warn__name__r9   r5   r6   r7   )r:   r<   r6   r   moduless        r#   add_itemz_MultipleClassMarker.add_item   s      .2]];cCE;? 
 ??g%II ??DMM3 	'++dD,=,=>? <s
   B;C r3   )rS   r   __qualname____doc__	__slots__r=   r%   rF   rN   r7   rU   rB   r.   r#   r   r   y   s-    
 7I,0!@r.   r   c                   D    e Zd ZdZdZd Zd Zd Zd Zd Z	d Z
d	 Zd
 Zy)r   z>Refers to a module name within
    _decl_class_registry.

    )parentnamer(   mod_nsrM   r1   c                     || _         || _        i | _        t        |       | _        | j                   r*| j                   j
                  | j                  gz   | _        ng | _        t        j                  |        y r3   )rZ   r[   r(   _ModNSr\   rM   r8   r9   )r:   r[   rZ   s      r#   r=   z_ModuleMarker.__init__   sX    	Tl;;((DII;6DIDIr.   c                     || j                   v S r3   rE   r:   r[   s     r#   __contains__z_ModuleMarker.__contains__   s    t}}$$r.   c                      | j                   |   S r3   rE   r`   s     r#   __getitem__z_ModuleMarker.__getitem__   s    }}T""r.   c                     | j                   j                  |d        | j                   sH| j                  ;| j                  j                  | j                         t
        j                  |        y y y r3   )r(   r   rZ   r7   r[   r8   rP   r`   s     r#   r7   z_ModuleMarker._remove_item   sQ    $%}}!8KK$$TYY/% "9}r.   c                 .    t        | j                  |      S r3   )getattrr\   r:   r)   s     r#   resolve_attrz_ModuleMarker.resolve_attr   s    t{{C((r.   c                 z    || j                   vrt        ||       }|| j                   |<   |S | j                   |   }|S r3   )r(   r   )r:   r[   markers      r#   r   z_ModuleMarker.get_module   sD    t}}$"4.F"(DMM$  ]]4(Fr.   c                       j                   v r! j                      }|j                  |       y t        |g fd      x} j                   <   y )Nc                  &    j                         S r3   )r7   )r[   r:   s   r#   <lambda>z)_ModuleMarker.add_class.<locals>.<lambda>   s    ):):4)@ r.   )r0   )r(   rU   r   r:   r[   r   r   s   ``  r#   r   z_ModuleMarker.add_class   sM    4== }}T*Hc"-A!@. Ht}}T*r.   c                 b    || j                   v r!| j                   |   }|j                  |       y y r3   )r(   r%   rn   s       r#   r&   z_ModuleMarker.remove_class   s/    4== }}T*H  % !r.   N)rS   r   rV   rW   rX   r=   ra   rc   r7   rh   r   r   r&   rB   r.   r#   r   r      s7    
 NI	%#&)&r.   r   c                       e Zd ZdZd Zd Zy)r^   )__parentc                     || _         y r3   )_ModNS__parent)r:   rZ   s     r#   r=   z_ModNS.__init__   s	    r.   c                 J   	 | j                   j                  |   }|Tt        |t              r|j                  S t        |t
              sJ |j                  | j                   j                  |      S t        d| j                   j                  d|      # t        $ r Y 0w xY w)NzModule z1 has no mapped classes registered under the name )rs   r(   r   r   r\   r   rN   rM   r   rL   r[   )r:   r)   values      r#   __getattr__z_ModNS.__getattr__   s    
	FMM**3/E  e]3 <<'%e-ABBB ,,T]]-?-?EE.2mm.@.@#G
 	
  		s   B 	B"!B"NrS   r   rV   rX   r=   rv   rB   r.   r#   r^   r^      s    I
r.   r^   c                       e Zd ZdZd Zd Zy)_GetColumnsr   c                     || _         y r3   rz   r?   s     r#   r=   z_GetColumns.__init__  s	    r.   c                    t        | j                  d      }|r||j                  vrt        d| j                  d|      |j                  |   }|j                  t
        j                  u rQ|j                  }t        |t              r|j                  }n(t        |t              st        j                  d|z        t        | j                  |      S )NF)	configurezClass z% does not have a mapped column named zaProperty %r is not an instance of ColumnProperty (i.e. does not correspond directly to a Column).)r   r   all_orm_descriptorsAttributeErrorextension_typer   NOT_EXTENSIONpropertyr   r   r[   r   r
   rI   rf   )r:   r)   mpdescprops        r#   rv   z_GetColumns.__getattr__  s    $((e4"000$xx& 
 ))#.D""j&>&>>}}dO4))C#D.9112478 
 txx%%r.   Nrw   rB   r.   r#   ry   ry   
  s    I&r.   ry   c                 @    t        j                  | j                        S r3   )r   inspectr   )targets    r#   rm   rm   (  s    :%%fjj1 r.   c                       e Zd ZdZd Zd Zy)	_GetTabler)   metadatac                      || _         || _        y r3   r   )r:   r)   r   s      r#   r=   z_GetTable.__init__/  s     r.   c                 \    | j                   j                  t        || j                           S r3   )r   tablesr   r)   rg   s     r#   rv   z_GetTable.__getattr__3  s"    }}##N3$ABBr.   Nrw   rB   r.   r#   r   r   ,  s    !I!Cr.   r   c                 \    t        |t              r|j                  g |       }t        |      S r3   )r   r   rN   ry   )r)   ru   s     r#   _determine_containerr   7  s*    %-.!!"c*ur.   c                   0    e Zd ZdZddZd Zd Zd Zd Zy)	_class_resolver)r   r   argfallback_dict
_resolversfavor_tablesc                     || _         || _        || _        || _        t	        j
                  | j                        | _        d| _        || _	        y )NrB   )
r   r   r   r   r   PopulateDict_access_clsr   r   r   )r:   r   r   r   r   r   s         r#   r=   z_class_resolver.__init__H  sE    	 &&t'7'78
(r.   c                    | j                   }t        j                  |      }|j                  }|j                  }|j
                  }| j                  rA||j                  v r|j                  |   S ||j                  v rt        ||j
                        S ||v rt        |||         S | j                  sA||j                  v r|j                  |   S ||j                  v rt        ||j
                        S d|v r||d   v r|d   }|j                  |      S | j                  r| j                  D ]  } ||      }	|	|	c S  | j                  |   S )Nr   )r   r   manager_of_classregistry_class_registryr   r   r   _schemasr   r   rh   r   r   )
r:   r)   r   manager	decl_baser   r   r   resolvru   s
             r#   r   z_class_resolver._access_clsQ  sT   hh--c2$$	'77%%hoo%s++))) cll33%%'-@-EFF  hoo%s++))) cll33 "%88*+@AA*+@AH((--__// !s$ L!
 }}S!!r.   c                     t        j                  t        j                  d| j                  j
                  d| j                  d|d| j                  d	      |       y )NzWhen initializing mapper z, expression z failed to locate a name (zG). If this is a class name, consider adding this relationship() to the z6 class after both dependent classes have been defined.)from_)r   raise_r
   rI   r   rZ   r   r   )r:   r[   errs      r#   _raise_for_namez_class_resolver._raise_for_namev  sC    ##
 99##TXXtTXX	? 		
r.   c                 z   | j                   }| j                  }d }	 |j                  d      D ]  }|||   }t        ||      } 	 t	        |t
              r|j                  S |S # t        $ r}| j                  ||       Y d }~y d }~wt        $ r)}| j                  |j                  d   |       Y d }~y d }~ww xY w)Nr   r   )r   r   r   rf   r   ry   r   r   r   rL   args)r:   r[   drvalr!   r   ns          r#   _resolve_namez_class_resolver._resolve_name  s    xxJJ	C 0<U8D"4/D	0 $,xx  	,  s++ 	/  A..	/s#   *A% %	B:.BB:B55B:c                     	 t        | j                  t               | j                        }t	        |t
              r|j                  S |S # t        $ r)}| j                  |j                  d   |       Y d }~y d }~ww xY w)Nr   )
evalr   globalsr   r   ry   r   rL   r   r   )r:   xr   s      r#   __call__z_class_resolver.__call__  sb    	/TXXwy$**5A![)uu 	/  A..	/s   AA	 A	 		A;A66A;NF)	rS   r   rV   rX   r=   r   r   r   r   rB   r.   r#   r   r   =  s#    I)#"J

(	/r.   r   c                      t         =dd l}ddlm}m} t        j                  |j                        j                  ||d      a d fd	} fd}||fS )Nr   )foreignremotec                 ,    t        t        | |      S )N)r   )r   _fallback_dict)r   r   r   r   s     r#   resolve_argz_resolver.<locals>.resolve_arg  s    ~s
 	
r.   c                 <    t        t        |       j                  S r3   )r   r   r   )r   r   r   s    r#   resolve_namez_resolver.<locals>.resolve_name  s    sD.#>LLLr.   r   )	r   
sqlalchemysqlalchemy.ormr   r   r   immutabledict__dict__union)r   r   r   r   r   r   r   s   ``     r#   	_resolverr     sR     2++J,?,?@FF62


M $$r.   )rW   r5    r   r   descriptor_propsr   
propertiesr   r   r   r
   r   
sql.schemar   r4   r8   r   r&   r-   objectr   r   r^   ry   	_inspectsr   r   r   r   r   rB   r.   r#   <module>r      s       - &     ' e%)P,.4=@6 =@@6&F 6&r
V 
0&& &: " 
  [ !1
C Cb/f b/J %r.   