Mf dZddlmZddlmZmZddZdZdZd Z dd Z Gd d eZ Gd deZ GddeZ ddZdZdS)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_idNcnttttfrdt DStt rfdDSgS)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 Nc>g|]\}}t||D]}|Sflatten_grouping).0group_el schema_elgs M/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/dash/_grouping.py z$flatten_grouping..&sM   #)%h ::       cRg|]#}t||D]}|$Sr r )r krgroupingschemas rrz$flatten_grouping..-s:TTTa+;HQKPQ+S+STTaTTTTr)validate_grouping isinstancetuplelistzipdict)rrs``rr r s~(F+++&5$-((   '*8V'<'<    &$UTTTTT6TTTT :rct|ttfrtd|DSt|tr+td|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 c,g|]}t|Sr  grouping_lenr r s rrz grouping_len..<s DDDxL**DDDrc,g|]}t|Sr rr!s rrz grouping_len..?s MMMxL**MMMrr)rrrsumrvalues)rs rr r 2sw(UDM**FDD8DDDEEE(D!!OMM8??;L;LMMMNNN 1rc pfdt|tstdt|t t |}t ||kr5td|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 c@t|ttfr)tfdt|DSt|tr.fdt|DSdS)Nc36K|]\}}|VdSNr )r iel_perform_make_grouping_like next_valuess r zNmake_grouping_by_index.._perform_make_grouping_like..RsHAr,+B <<rc6i|]\}\}}||Sr r )r r)rvr+r,s r zOmake_grouping_by_index.._perform_make_grouping_like..XsAAv1..q+>>rr)rrr enumerateritemspop)valuer,r+s `rr+z;make_grouping_by_index.._perform_make_grouping_likePs eeT] + + &u--  eT " " !*5;;==!9!9  q!!!rz@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 ValueErrortypelenr repr)r flat_valuesexpected_lengthr+s @rmake_grouping_by_indexr;Ds " " " " " k4 ( (  :&*;&7&7 : :   *62233O ;?** ) ) )%(%5%5 ) )%)&\\ ) )' ) )    ' &vtK/@/@ A AArct|ttfrfd|DSt|tr-t fd|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. c0g|]}t|Sr  map_grouping)r rfns rrz map_grouping..|s#666 R##666rc8i|]\}}|t|Sr r>)r rrr@s rr0z map_grouping..s)RRRAab!!4!4RRRr)rrrrrr2)r@rs` rr?r?qs(UDM**76666X6666(D!!TRRRRAQAQRRRSSS 2h<<rc.tfd|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 c0|Sr()get)sdefaultsources rz&make_grouping_by_key..s&**Q"8"8rr>)rrGrFs ``rmake_grouping_by_keyrIs# 88888& A AArc4eZdZfdZedZxZS)SchemaTypeValidationErrorctd|dt|d|dt|dt|d dS)N Schema:  Path: z Expected type: z( Received value of type :  msg)super__init__r8r6)selfr4 full_schemapath expected_type __class__s rrTz"SchemaTypeValidationError.__init__s $Dzz!.)-U  %[[       rcJt||st||||dSr()rrK)clsr4rVrWrXs rcheckzSchemaTypeValidationError.checks5%// U+E;mTT T U Ur__name__ __module__ __qualname__rT classmethodr\ __classcell__rYs@rrKrKZ      UU[UUUUUrrKc4eZdZfdZedZxZS)SchemaLengthValidationErrorctd|dt|d|dt|dt|d dS)NrMrNz" Expected length: z* Received value of length rOrPrQ)rSrTr8r7)rUr4rVrW expected_lenrYs rrTz$SchemaLengthValidationError.__init__s $Dzz#/+.e**  %[[       rcPt||krt||||dSr()r7rf)r[r4rVrWrhs rr\z!SchemaLengthValidationError.checks/ u:: % %-e[$ UU U & %rr]rcs@rrfrfsZ      VV[VVVVVrrfc4eZdZfdZedZxZS)SchemaKeysValidationErrorctd|dt|d|dt|dt|d dS)NrMrNz Expected keys: z* Received value with keys rOrPrQ)rSrTr8setkeys)rUr4rVrW expected_keysrYs rrTz"SchemaKeysValidationError.__init__s $Dzz!.+.ejjll*;*;  %[[       rct|t|krt||||dSr()rmrnrk)r[r4rVrWros rr\zSchemaKeysValidationError.checksA uzz||  M 2 2 2 2+E;mTT T 3 2rr]rcs@rrkrkrdrrkr c||}t|ttfrt|||ttft |||t |tt||D]\}\}}t|||||fz dSt|trvt|||tt|||t||D]%}t|||||||fz&dSdS)zx Validate that the provided grouping conforms to the provided schema. If not, raise a SchemaValidationError N)rVrW) rrrrKr\rfr7r1rrrrkrm)rrrVrWr)rrErs rrrsY  &5$-(( !''+teT]SSS#))(Ks6{{SSS"3x#8#899 O OIAv1 a $!+ N N N N N O O FD ! !  !''+tTJJJ!''+tS[[QQQ  A  VAYKdaTk        rcFt|trt|d}|d|d}|d|||vt|dtrt |dn|dd}||dSdS)Nid.propertyr4)r4str_id triggeredrs)rrrrDrupdate)rrwrvprop_id new_valuess rupdate_args_groupr{s!T ag&&--a m--UU7^^ I-,6qw,E,ER-$(((1T7     rr()Nr )__doc__dash.exceptionsr_utilsrrr r r;r?rIrKrfrkrr{r rrrs^766666////////<   $*B*B*BZ& B B B BUUUUU :UUU$VVVVV"<VVV$UUUUU :UUU$    4     r