o nګe@sdZddlmZmZddlmZmZmZddlZddl Z ddl m Z ddgZ e eGdddeZe eGd ddeeZdS) z! Mixin Classes for Attr-support. )ABCMetaabstractmethod)MappingMutableMappingSequenceN)mergeAttr MutableAttrc@s\eZdZdZeddZeddZddZdd Z d d Z d d Z ddZ eddZ dS)ra A mixin class for a mapping that allows for attribute-style access of values. A key may be used as an attribute if: * It is a string * It matches /^[A-Za-z][A-Za-z0-9_]*$/ (i.e., a public attribute) * The key doesn't overlap with any class attributes (for Attr, those would be 'get', 'items', 'keys', 'values', 'mro', and 'register'). If a values which is accessed as an attribute is a Sequence-type (and is not a string/bytes), it will be converted to a _sequence_type with any mappings within it converted to Attrs. NOTE: This means that if _sequence_type is not None, then a sequence accessed as an attribute will be a different object than if accessed as an attribute than if it is accessed as an item. cCsdS)zv All required state for building a new instance with the same settings as the current object. Nselfr r f/vol/project/2023/60021/g236002117/DeepSeek-Coder/venv/lib/python3.10/site-packages/attrdict/mixins.py_configuration&szAttr._configurationcCstd)a_ A standardized constructor used internally by Attr. mapping: A mapping of key-value pairs. It is HIGHLY recommended that you use this as the internal key-value pair mapping, as that will allow nested assignment (e.g., attr.foo.bar = baz) configuration: The return value of Attr._configuration zYou need to implement this)NotImplementedError)clsmapping configurationr r r _constructor-s zAttr._constructorcCs,||vrtdj|jj|d|||S)z Dynamically access a key-value pair. key: A key associated with a value in the mapping. This differs from __getitem__, because it returns a new instance of an Attr (if the value is a Mapping object). z)'{cls} instance has no attribute '{name}'rname)AttributeErrorformat __class____name___buildr keyr r r __call__9s z Attr.__call__cCs6||vs ||stdj|jj|d|||S)z1 Access an item as an attribute. z*'{cls}' instance has no attribute '{name}'r) _valid_namerrrrrrr r r __getattr__KszAttr.__getattr__cCs$t|tstS|t|||S)z Add a mapping to this Attr, creating a new, merged Attr. other: A mapping. NOTE: Addition is not commutative. a + b != b + a.  isinstancerNotImplementedrrrr otherr r r __add__X z Attr.__add__cCs$t|tstS|t|||S)z Add this Attr to a mapping, creating a new, merged Attr. other: A mapping. NOTE: Addition is not commutative. a + b != b + a. r r#r r r __radd__er&z Attr.__radd__csdt|tr|}|St|tr0t|tjtjfs0tdd}|r0|fdd|D}|S)a Conditionally convert an object to allow for recursive mapping access. obj: An object that was a key-value pair in the mapping. If obj is a mapping, self._constructor(obj, self._configuration()) will be called. If obj is a non-string/bytes sequence, and self._sequence_type is not None, the obj will be converted to type _sequence_type and build will be called on its elements. _sequence_typeNc3s|]}|VqdS)N)r).0elementr r r szAttr._build..) r!rrrrsix string_types binary_typegetattr)r obj sequence_typer r r rrs   z Attr._buildcCs$t|tjotd|ot|| S)a} Check whether a key is a valid attribute name. A key may be used as an attribute if: * It is a string * It matches /^[A-Za-z][A-Za-z0-9_]*$/ (i.e., a public attribute) * The key doesn't overlap with any class attributes (for Attr, those would be 'get', 'items', 'keys', 'values', 'mro', and 'register'). z^[A-Za-z][A-Za-z0-9_]*$)r!r,r-rematchhasattr)rrr r r rs  zAttr._valid_nameN)r __module__ __qualname____doc__rr classmethodrrrr%r'rrr r r r rs      csFeZdZdZfddZfddZfddZd fd d ZZS) r z[ A mixin class for a mapping that allows for attribute-style access of values. cstt|||dS)zo Add an attribute to the object, without attempting to add it as a key to the mapping. N)superr __setattr__r rvaluerr r _setattrszMutableAttr._setattrcsL||r |||<dSt|ddrtt|||dStdj|jjd)zr Add an attribute. key: The name of the attribute value: The attributes contents _allow_invalid_attributesTz*'{cls}' does not allow attribute creation.rN) rr/r9r r: TypeErrorrrrr;r=r r r:s   zMutableAttr.__setattr__cstt||dS)zp Delete an attribute from the object, without attempting to remove it from the mapping. N)r9r __delattr__rr=r r _delattrszMutableAttr._delattrFcsH||r ||=dSt|ddrtt||dStdj|jjd)zN Delete an attribute. key: The name of the attribute r?Tz*'{cls}' does not allow attribute deletion.r@N) rr/r9r rBrArrr)r rforcer=r r rBs   zMutableAttr.__delattr__)F) rr5r6r7r>r:rCrB __classcell__r r r=r r s    )r7abcrr collectionsrrrr2r,attrdict.merger__all__ add_metaclassrr r r r r s