$g dZddlmZddlmZmZddZdZdZd Z dd Z Gd d eZ Gd deZ GddeZ ddZdZy)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_idNc F||}n t||t|ttfr2t ||Dcgc]\}}t ||D]}|c}}}St|t r)|Dcgc]}t ||||D]}|c}}S|gScc}}}wcc}}w)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 )validate_grouping isinstancetuplelistzipflatten_groupingdict)groupingschemagroup_el schema_elgks K/var/www/dash_apps/app1/venv/lib/python3.12/site-packages/dash/_grouping.pyr r s~(F+&5$-((+8V'<  #)%h :     &$!Ta+;HQKPQ+STaTTT : Us B/ Bct|ttfr"t|Dcgc] }t |c}St|t r0t|j Dcgc] }t |c}Sycc}wcc}w)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 r)r r r sum grouping_lenrvalues)rrs rrr2sh(UDM*8DxL*DEE(D!8??;LMxL*MNN ENs A: A?c fdt|tstdt|t t |}t ||k7r)td|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 0t|ttfrtfdt|DSt|tr9t|j Dcic]\}\}}||c}}}Sj dScc}}}w)Nc36K|]\}}|ywN).0iel_perform_make_grouping_like next_valuess r zNmake_grouping_by_index.._perform_make_grouping_like..Rs$Ar,B <sr)r r r enumerateritemspop)valuer#r rvr"s ` rr"z;make_grouping_by_index.._perform_make_grouping_likePs eeT] +&u-  eT ""+5;;=!9Av1.q+>>  q!! s$Bz@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: )r r ValueErrortypelenr repr)r flat_valuesexpected_lengthr"s @rmake_grouping_by_indexr0Ds " k4 ( &&*;&7%8 :  *623O ;?*66GH%%(%5$67%%)&\N3&- )   'vtK/@ AAc t|ttfr|Dcgc]}t||c}St|tr7t |j Dcic]\}}|t||c}}S||Scc}wcc}}w)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. )r r r map_groupingrrr&)fnrrrs rr3r3qsv(UDM*-56 R#66(D!AQRAab!!44RSS h< 7Ss BB c&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 c(j|Sr)get)sdefaultsources rz&make_grouping_by_key..s&**Q"8r1)r3)rr:r9s ``rmake_grouping_by_keyr<s 8& AAr1c.eZdZfdZedZxZS)SchemaTypeValidationErrorc|t|d|dt|d|dt|dt|d y)N Schema:  Path: z Expected type: z( Received value of type :  msg)super__init__r-r+)selfr( full_schemapath expected_type __class__s rrGz"SchemaTypeValidationError.__init__s] $ &Dzl# -/((,U }5%[M"   r1c8t||st||||yr)r r>)clsr(rIrJrKs rcheckzSchemaTypeValidationError.checks"%/+E;mT T0r1__name__ __module__ __qualname__rG classmethodrO __classcell__rLs@rr>r>  UUr1r>c.eZdZfdZedZxZS)SchemaLengthValidationErrorc|t|d|dt|d|dt|dt|d y)Nr@rAz" Expected length: z* Received value of length rBrCrD)rFrGr-r,)rHr(rIrJ expected_lenrLs rrGz$SchemaLengthValidationError.__init__s] $ &Dzl#"".0**-e*6%[M"   r1c<t||k7rt||||yr)r,rY)rNr(rIrJr[s rrOz!SchemaLengthValidationError.checks$ u: %-e[$ U U &r1rPrVs@rrYrYs  VVr1rYc.eZdZfdZedZxZS)SchemaKeysValidationErrorct|d|dt|d|dt|j dt|d y)Nr@rAz Expected keys: z* Received value with keys rBrCrD)rFrGr-setkeys)rHr(rIrJ expected_keysrLs rrGz"SchemaKeysValidationError.__init__se $ &Dzl# -/**-ejjl*;)<=%[M"   r1cjt|jt|k7rt||||yr)r`rar^)rNr(rIrJrbs rrOzSchemaKeysValidationError.checks0 uzz| M 2 2+E;mT T 3r1rPrVs@rr^r^rWr1r^c||}t|ttfrwtj |||ttft j |||t |tt||D]\}\}}t|||||fzyt|tr^tj |||ttj |||t||D]}t|||||||fzyy)zx Validate that the provided grouping conforms to the provided schema. If not, raise a SchemaValidationError N)rIrJ) r r r r>rOrYr,r%r rrr^r`)rrrIrJr rr8rs rrrs  &5$-(!''+teT]S#))(Ks6{S"3x#89 OIAv1 a $!+ N O FD !!''+tTJ!''+tS[Q A  VAYKdaTk   r1ct|trft|d}|d|d}|jd|||vt|dtrt |dn|dd}|j |yy)Nid.propertyr()r(str_id triggeredrf)r rrr7rupdate)rrjriprop_id new_valuess rupdate_args_grouprns!Tag&HAa m_-UU7^ I-,6qw,E-$(1T7  r1r)Nr)__doc__dash.exceptionsr_utilsrrr rr0r3r<r>rYr^rrnrr1rrrse7/< $*BZ& BU :U$V"<V$U :U$ 4 r1