HaHdZddlZejdkrddlmZnddlmZddlmZddlm Z m Z m Z e e Z e Gdd eZy) z$ Dot notation support for Mappings. N)r)Mapping) AttMapLike)copy get_loggersafedel_messagecfeZdZdZdZdZdZdZdZe dZ dZ e d Z d Zd Zd Zy )AttMapa A class to convert a nested mapping(s) into an object(s) with key-values using object syntax (attmap.attribute) instead of getitem syntax (attmap["key"]). This class recursively sets mappings to objects, facilitating attribute traversal (e.g., attmap.attr.attr). cz |j|=y#t$r!tjt |YywxYwN)__dict__KeyError_LOGGERdebugr )selfkeys -lib/python3.12/site-packages/attmap/attmap.py __delitem__zAttMap.__delitem__s3 0 c" 0 MM/#. / 0s '::c |j|Sr )r)ritems r __getitem__zAttMap.__getitem__s}}T""cB|j|||j|<y)a* This is the key to making this a unique data type. :param str key: name of the key/attribute for which to establish value :param object value: value to which set the given key; if the value is a mapping-like object, other keys' values may be combined. N)_final_for_storer)rrvalues r __setitem__zAttMap.__setitem__"s"223> crc,t|t|k7st|t|k7ry|jD]R\}}|j|r%tj dj |<|j|||rRyy)NFzExcluding from comparison: {}T)typelenitems _excl_from_eqrrformat_cmp)rotherkvs r__eq__z AttMap.__eq__.s J$u+ %3t9E +BJJL DAq!!!$ =DDQGH99Qa)   rc||k( Sr )rr%s r__ne__z AttMap.__ne__:s5=  rcd d}|||ddgs |||dgrd}n|||dgrd}nd} |||S#t$rYy wxYw) zAHook to tailor value comparison in determination of map equality.cxt|jt|j}}|r ||vxr||vS||k(Sr )str __class__)obj1obj2 typenamest1t2s r same_typezAttMap._cmp..same_typeAs<(#dnn*=Bzz#c(||k(jSr allxys rzAttMap._cmp..Hs!q&rz%cD||k(jjSr r7r9s rr<zAttMap._cmp..Js!q&!3!3!5rc ||k(Sr r*r9s rr<zAttMap._cmp..Ls arFr ) ValueError)abr5checks rr$z AttMap._cmp=st T  q+-FG q!CD E/E q!EF G5E'E A;   s< AActt|tr't||js|j|}|S)z Before storing a value, apply any desired transformation. :param hashable k: key for which to store value :param object v: value to potentially transform before storing :return object: finalized value ) isinstancer_lower_type_bound_metamorph_maplike)rr&r's rrzAttMap._final_for_storeTs2 a !*Q8N8N*O''*ArctSr )r rs rrEzAttMap._lower_type_bound`s rct|ts$tdj|t ||j |j S)a" Ensure a stored Mapping conforms with type expectation. :param Mapping m: the mapping to which to apply type transformation :return Mapping: a (perhaps more specialized) version of the given map :raise TypeError: if the given value isn't a Mapping z+Cannot integrate a non-Mapping: {} Type: {})rDr TypeErrorr#rrEr!)rms rrFzAttMap._metamorph_maplikedsH!W%>EEaaQ %%aggi00rctS)zDReturn the empty collection builder for Mapping type simplification.)dictrHs r_new_empty_basic_mapzAttMap._new_empty_basic_maprs v rcF|j|st|SdS)a1 IPython display; https://ipython.readthedocs.io/en/stable/api/generated/IPython.lib.pretty.html :param IPython.lib.pretty.PrettyPrinter p: printer instance :param bool cycle: whether a cyclic reference is detected :return str: text representation of the instance z...)textrepr)rpcycles r _repr_pretty_zAttMap._repr_pretty_vs!vvd4j99599rN)__name__ __module__ __qualname____doc__rrrr(r+ staticmethodr$rpropertyrErFrNrTr*rrr r s\0 # ? !,  1:rr )rXsys version_info collectionsrcollections.abc _att_map_likerhelpersrrr rUrr r*rrrasP* f#'%66 X m:Zm:m:r