U Zf @sdZddlmZddlmZmZdddZdd Zd d Zd d Z dddZ GdddeZ GdddeZ GdddeZ dddZddZdS)a This module contains a collection of utility function for dealing with property groupings. Terminology: For the purpose of grouping and ungrouping, tuples/lists and dictionaries are considered "composite values" and all other values are considered "scalar values". A "grouping value" is either composite or scalar. A "schema" is a grouping value that can be used to encode an expected grouping structure )InvalidCallbackReturnValue) AttributeDict stringify_idNcs^dkrn ttttfr:ddtDSttrXfddDSgS)a Convert a grouping value to a list of scalar values :param grouping: grouping value to flatten :param schema: If provided, a grouping value representing the expected structure of the input grouping value. If not provided, the grouping value is its own schema. A schema is required in order to be able treat tuples and dicts in the input grouping as scalar values. :return: list of the scalar values in the input grouping NcSs$g|]\}}t||D]}|qqSflatten_grouping).0group_elZ schema_elgrr2/tmp/pip-unpacked-wheel-47crqvv_/dash/_grouping.py &s z$flatten_grouping..cs(g|] }t||D]}|qqSrrr kr groupingschemarr r -s)validate_grouping isinstancetuplelistzipdictrrrr rs   rcCsDt|ttfr tdd|DSt|tr@tdd|DSdS)aU Get the length of a grouping. The length equal to the number of scalar values contained in the grouping, which is equivalent to the length of the list that would result from calling flatten_grouping on the grouping value. :param grouping: The grouping value to calculate the length of :return: non-negative integer cSsg|] }t|qSr grouping_lenr r rrr r <sz grouping_len..cSsg|] }t|qSrrrrrr r ?sr)rrrsumrvalues)rrrr r2s  rc svfddt|ts(tdt|tt|}t||krhtd|dt|dt|d||t|S)a Make a grouping like the provided grouping schema, with scalar values drawn from a flat list by index. Note: Scalar values in schema are not used :param schema: Grouping value encoding the structure of the grouping to return :param flat_values: List of values with length matching the grouping_len of schema. Elements of flat_values will become the scalar values in the resulting grouping csZt|ttfr*tfddt|DSt|trPfddt|DSdS)Nc3s|]\}}|VqdSNr)r iel_perform_make_grouping_like next_valuesrr RszNmake_grouping_by_index.._perform_make_grouping_like..cs i|]\}\}}||qSrr)r rrvr!rr Xs zOmake_grouping_by_index.._perform_make_grouping_like..r)rrr enumerateritemspop)valuer#r")r#r r"Ps   z;make_grouping_by_index.._perform_make_grouping_likez@The flat_values argument must be a list. Received value of type z(The specified grouping pattern requires z elements but received z Grouping pattern: z Values: )rr ValueErrortypelenrrepr)rZ flat_valuesZexpected_lengthrr+r make_grouping_by_indexDs     "r0csLt|ttfr fdd|DSt|trDtfdd|DS|S)a Map a function over all of the scalar values of a grouping, maintaining the grouping structure :param fn: Single-argument function that accepts and returns scalar grouping values :param grouping: The grouping to map the function over :return: A new grouping with the same structure as input grouping with scalar values updated by the input function. csg|]}t|qSr map_grouping)r r fnrr r |sz map_grouping..csi|]\}}|t|qSrr1rr3rr r&sz map_grouping..)rrrrrr()r4rrr3r r2qs  r2cstfdd|S)a Create a grouping from a schema by using the schema's scalar values to look up items in the provided source object. :param schema: A grouping of potential keys in source :param source: Dict-like object to use to look up scalar grouping value using scalar grouping values as keys :param default: Default scalar value to use if grouping scalar key is not present in source :return: grouping cs |Sr)get)sdefaultsourcerr z&make_grouping_by_key..r1)rr9r8rr7r make_grouping_by_keys r<cs(eZdZfddZeddZZS)SchemaTypeValidationErrorc s>tjd|dt|d|dt|dt|d ddS)N Schema:  Path: z Expected type: z( Received value of type :  msg)super__init__r/r-)selfr* full_schemapath expected_type __class__rr rEsz"SchemaTypeValidationError.__init__cCst||st||||dSr)rr=)clsr*rGrHrIrrr checks zSchemaTypeValidationError.check__name__ __module__ __qualname__rE classmethodrM __classcell__rrrJr r=s r=cs(eZdZfddZeddZZS)SchemaLengthValidationErrorc s>tjd|dt|d|dt|dt|d ddS)Nr>r?z" Expected length: z* Received value of length r@rArB)rDrEr/r.)rFr*rGrH expected_lenrJrr rEsz$SchemaLengthValidationError.__init__cCst||krt||||dSr)r.rT)rLr*rGrHrUrrr rMs z!SchemaLengthValidationError.checkrNrrrJr rTs rTcs(eZdZfddZeddZZS)SchemaKeysValidationErrorc sBtjd|dt|d|dt|dt|d ddS)Nr>r?z Expected keys: z* Received value with keys r@rArB)rDrEr/setkeys)rFr*rGrH expected_keysrJrr rEs z"SchemaKeysValidationError.__init__cCs&t|t|kr"t||||dSr)rWrXrV)rLr*rGrHrYrrr rMszSchemaKeysValidationError.checkrNrrrJr rVs rVrcCs|dkr |}t|ttfrvt|||ttft|||t|tt||D]"\}\}}t |||||fdqPnXt|t rt|||t t |||t ||D]"}t |||||||fdqndS)zx Validate that the provided grouping conforms to the provided schema. If not, raise a SchemaValidationError N)rGrH) rrrr=rMrTr.r'rrrrVrW)rrrGrHrr r6rrrr rs$  rcCslt|trht|d}|d|d}|d|||kt|dtrRt|dn|dd}||dS)Nid.propertyr*)r*str_id triggeredrZ)rrrr5rupdate)r r^r]Zprop_idZ new_valuesrrr update_args_groups   r`)N)N)Nr)__doc__Zdash.exceptionsr_utilsrrrrr0r2r<r=rTrVrr`rrrr s  -