B 5d@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. N)selfr r 3/tmp/pip-unpacked-wheel-akj3st3j/attrdict/mixins.py_configuration&szAttr._configurationcCs tddS)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 thisN)NotImplementedError)clsmapping configurationr r r _constructor-s zAttr._constructorcCs,||krtdj|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___build)r keyr r r __call__9s z Attr.__call__cCs6||ks||s(tdj|jj|d|||S)z1 Access an item as an attribute. z*'{cls}' instance has no attribute '{name}')rr) _valid_namerrrrr)r rr r r __getattr__Ks zAttr.__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. ) isinstancerNotImplementedrrr )r otherr r r __add__Xs 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. )rrrrrr )r rr r r __radd__es z Attr.__radd__csbt|tr|}nBt|tr^t|tjtjfs^tdd}|r^|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. Z_sequence_typeNc3s|]}|VqdS)N)r).0element)r r r szAttr._build..) rrrr rsix string_types binary_typegetattr)r objZ sequence_typer )r r rrs   z Attr._buildcCs$t|tjo"td|o"t|| 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_]*$)rr%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 rvalue)rr r _setattrszMutableAttr._setattrcsL||r|||<n4t|ddr4tt|||ntdj|jjddS)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(r1r r2 TypeErrorrrr)r rr3)rr r r2s   zMutableAttr.__setattr__cstt||dS)zp Delete an attribute from the object, without attempting to remove it from the mapping. N)r1r __delattr__)r r)rr r _delattrszMutableAttr._delattrFcsH||r||=n2t|ddr0tt||ntdj|jjddS)zN Delete an attribute. key: The name of the attribute r5Tz*'{cls}' does not allow attribute deletion.)rN) rr(r1r r7r6rrr)r rforce)rr r r7s  zMutableAttr.__delattr__)F) rr-r.r/r4r2r8r7 __classcell__r r )rr r s    )r/abcrr collectionsrrrr*r%Zattrdict.merger__all__ add_metaclassrr r r r r s