U ZfP@s,ddlZddlmZddlZddlmZddlmZddlZddl m Z m Z ddl m Z ddlmZdd lmZmZmZmZmZd d Zd d ZddZddZddZddZddZddZddZddZddZ d d!Z!d"d#Z"d$d%Z#d&d'Z$d(d)Z%d*d+Z&d,d-Z'd.d/Z(d0d1Z)d2d3Z*dS)4N)MutableSequence)dedent) iskeyword) grouping_len map_grouping) Component) exceptions)patch_collections_abc stringify_idto_jsoncoerce_to_listclean_property_namec Cs|\}}}|rlt|d|||fs@ttdt|ddttd|||dd|dd|||fD]}|D] } t| q~qvdS)Nrz Callback arguments must be `Output`, `Input`, or `State` objects, optionally wrapped in a list or tuple. We found (possibly after unwrapping a list or tuple):  z In a callback definition, you must provide all Outputs first, then all Inputs, then all States. After this item: z: we found this item next:  ) isinstancer IncorrectTypeExceptionrreprvalidate_callback_arg) outputsinputsstate extra_argstypesZInputOutputStateargsargr2/tmp/pip-unpacked-wheel-47crqvv_/dash/_validate.pyvalidate_callbacks$     r!cCstt|ddts*ttd|jdt|dr>tdt|j t rTt |n.t|j trjt |nttd|j ddS)Ncomponent_propertyz< component_property must be a string, found rZcomponent_eventzd Events have been removed. Use the associated property instead. z> component_id must be a string or dict, found ) rgetattrstrr rrr"hasattrZNonExistentEventException component_iddictvalidate_id_dictvalidate_id_string)rrrr r4s&       rc Cs:|j}|D]*}t|ts ttd|d|dq dS)Nz[ Wildcard ID keys must be non-empty strings, found z in id r)r&rr$r rr)rarg_idkrrr r(Vs r(c sN|jd}fdd|D}|rJtddd|dd|ddS) Nz.{csg|]}|kr|qSrr.0xr*rr lsz&validate_id_string..z The element `z ` contains `z`, `z%` in its ID. Characters `z&` are not allowed in IDs. )r&r ZInvalidComponentIdErrorjoin)rZ invalid_charsZ invalid_foundrr/r r)hsr)cCst|ttfs|g|g}}nt|t|kr8tdt||D]N\}}t|ttfr\|n|g}|D](}||dt|d|ksftdqfqBdS)z This validation is for security and internal debugging, not for users, so the messages are not intended to be clear. `output` comes from the callback definition, `output_spec` from the request. zWrong length output_specidpropertyz)Output does not match callback definitionN)rlisttuplelenr CallbackExceptionzipr)output output_specrZoutiZspeciZ speci_listZspecijrrr validate_output_specvs r;cst|tkrtdtfdd|}t|trbg}|}|D]}|sBt|dqBn&t|tt fr~t |}i}n |g}i}||fS)Nz'Inputs do not match callback definitioncs|SNr)ind flat_argsrr z/validate_and_group_input_args..z$ is not a valid Python variable name) rr6r r7rrr' isidentifierr5r4)r?Zarg_index_groupingZ args_grouping func_argsZ func_kwargskeyrr>r validate_and_group_input_argss"  rEcCs t|ttfs*ttd|d|dt|t|kr`td|dt|dt|dt|D]\}}t|trh||}t|ttfsttd|d |d |d |d t|t|krhttd |d|dt|dt|d|d|d qhdS)Nz The callback zl is a multi-output. Expected the output type to be a list or tuple but got: z. z1 Invalid number of output values for z. Expected z, got z& The callback z output z is a wildcard multi-output. Expected the output type to be a list or tuple but got: z'. output spec: z z= Invalid number of output values for z item z#. Expected z& output spec: z' output value: )rr4r5r InvalidCallbackReturnValuerr6 enumerate)Z output_listsZ output_valuesZ callback_idir: output_valuerrr validate_multi_returnsZ    rKcsttttdtfttttdttfdfdd fddfddfdd dfd d }t|trt |D]\}}|||d q~n||t d ddS)NFc st|j}t|ddr&d|jddnd}t|j}|rBtd}n<|dkrNdn d |d d } td | d |d |d|d }|sdnd} ttdd| dd|d|d|d dS)Nr2Fz(id=s)z The value in question is either the only value returned, or is in the top level of the returned list, z[*][d]zE The value in question is located at  rz, ztree with one valuevaluez# The callback for `z` returned a z having type `zC` which is not JSON serializable. z@ and has string representation `z` In general, Dash properties can only be dash components, strings, dictionaries, numbers, None, or lists of those. )type__name__r#r2rr rG) bad_val outer_valpathindextoplevelZbad_typeZouter_idZ outer_typelocationZ index_stringobj)r9rr _raise_invalids>    z,fail_callback_output.._raise_invalidcs t|Sr<rval)valid_childrenrr _valid_childsz*fail_callback_output.._valid_childcs t|Sr<r^r_) valid_propsrr _valid_propsz)fail_callback_output.._valid_propcs<|s|sdSz t|Wntk r6YdSXdS)NFT)r TypeErrorr_)rbrdrr _can_serializes z,fail_callback_output.._can_serializecsPt|tr*g}|D]\}|s8|||d|s~fdd|D}|rZqtfdd|Dr~||ft|dd}t|ttfs|r|s||ddt|j |dq|r|d \}|||dt|dd}t|ttfs*|r*|s*||t|j |d|sL|t|j d |d d dS) N)rVrWrXrYcsg|]}|ds|qSr startswithr-rIprr r0szAfail_callback_output.._validate_value..c3s|]}|d VqdS)rNrhrjrkrr %sz@fail_callback_output.._validate_value..children z[*] rrNT)rVrWrXrYrZ) rrZ_traverse_with_pathsallappendr#r5rrTrU)r`rYZunserializable_itemsjchild)rfr]rbrkr _validate_valuesT       z-fail_callback_output.._validate_valuerYz" The callback for output `z` returned a value which is not JSON serializable. In general, Dash properties can only be dash components, strings, dictionaries, numbers, None, or lists of those. )NF)N) r$intfloatrTrr5rrr4rHr rG)rJr9rtrIr`r)rfr]rbrdr9rarcr fail_callback_outputs(   =  rxcCsV|D]L}|dkr"td|d|dkr@t|dtjdqtd|dqdS) N)Zcomponents_cache_max_ageZ static_folderrz is no longer a valid keyword argument in Dash since v1.0. See https://dash.plotly.com for details. )Zdynamic_loadingZpreloaded_librarieszA has been removed and no longer a valid keyword argument in Dash.)filez+Dash() got an unexpected keyword argument '')r ZObsoleteKwargExceptionprintsysstderrre)kwargsrDrrr check_obsolete_src CsV||kr(td|dt|d|||krRtd|d|d|ddS)Nz( Error loading dependency. "zQ" is not a registered library. Registered libraries are: rFz "zV" is registered but the path requested is not valid. The path requested: "z(" List of registered paths: )r ZDependencyExceptionr4keys)Zregistered_paths package_nameZpath_in_package_distrrr validate_js_pathss$  rc sRfdd|D}|rNt|dkr&dnd}td|dd|d |d dS) Ncs$g|]\}}t|s|qSr)recompilesearch)r-checkrIrurr r0sz"validate_index..rrLrNz Missing itemrRz, z in .)r6r ZInvalidIndexExceptionr1)nameZchecksrYmissingpluralrrur validate_indexs rcCs$t|ttdttfs tddS)NCallablez Layout must be a single dash component, a list of dash components, or a function that returns a dash component. )rrr r4r5r NoLayoutException)rSrrr validate_layout_typesrcsx|dkrtdtfdd}t|ttfrl|D]2}t|tfrHq6t|tfr^||q6tdq6n||dS)Nz The layout was `None` at the time that `run_server` was called. Make sure to set the `layout` attribute of your application before running the server. cs.fdd}|||D] }||qdS)Ncs<tt|dd}|r.|kr.td|d|dS)Nr2zJ Duplicate component id found in the initial layout: `z` )r r#r ZDuplicateIdErroradd)compr&Z component_idsrr _validate_ids z8validate_layout.._validate.._validate_id)Z _traverse)rSr componentrrr _validates  z"validate_layout.._validatez9Only strings and components are allowed in a list layout.)r rsetrr4r5r$r)layoutZ layout_valuerrrrr validate_layouts     rcCs@td|}|D]*}|r$t|rtd|d|dqdS)Nz<(.*?)>`z;` is not a valid Python variable name in `path_template`: "z".)rfindallrBr Exception)templateZvariable_namesrrrr validate_templates  rcCsvi}|D]:}|d|kr0|dg||d<q ||d|dq |D] }t|dkrPtd|dqPdS)NrXmodulerzmodules z have duplicate paths)valuesrqr6r)registryZpath_to_modulepagemodulesrrr check_for_duplicate_pathnamess    rcCsD|D]6}d|kr*td|dd|ddkrtdqdS)NrzNo layout in module `rz` in dash.page_registry__main__z When registering pages from app.py, `__name__` is not a valid module name. Use a string instead. For example, `dash.register_page("my_module_name")`, rather than `dash.register_page(__name__)` )rr rr)rrrrr validate_registrys  rcCs t|dstd|ddS)Nrz' No layout found in module zN A variable or a function named "layout" is required. )r%r r)rrrrr validate_pages_layouts  rcCs,|ddstdtr(tddS)NZ assets_folderz=`dash.register_page()` must be called after app instantiationu dash.register_page() can’t be called within a callback as it updates dash.page_registry, which is a global variable. For more details, see https://dash.plotly.com/sharing-data-between-callbacks#why-global-variables-will-break-your-app )getr PageErrorflaskZhas_request_context)configrrr validate_use_pagess rcCst|tstd|S)NzJThe first attribute of dash.register_page() must be a string or '__name__')rr$r r)rrrr validate_module_names  rc st}i}|D]H}t|d}|||D](}||t||t|dq0qdd|DD]}|d}|dg}|dg}t|dtdd |D|fd d tfd d|DD} | rntd | d qndS)Nr9Z raw_inputscss|]}|dr|VqdS)longN)rr,rrr rms z*validate_long_callbacks..rprogressrunningcSsg|] }|dqSrgrr,rrr r0sz+validate_long_callbacks..csg|]}|kr|qSrrr,) long_inputsrr r0 sc3s |]\}}|r|VqdSr<) intersection)r-r+v)rrr rm"s zLong callback circular error! z~ is used as input for a long callback but also used as output from an input that is updated with progress or running argument.) rrr update setdefaultritemsr ZLongCallbackError) Z callback_mapZ all_outputsZ input_indexedcallbackoutoZ long_inforrZcircularr)rrr validate_long_callbacks s*        rcsNdfkrdSfdd}t|ttfrB|D] }||q0dS||dS)NZinitial_duplicatecs|jrsstddS)Na*allow_duplicate requires prevent_initial_call to be True. The order of the call is not guaranteed to be the same on every page load. To enable duplicate callback with initial call, set prevent_initial_call='initial_duplicate' or globally in the config prevent_initial_callbacks='initial_duplicate')Zallow_duplicater ZDuplicateCallback)rconfig_prevent_initial_callprevent_initial_callrr _valid3sz)validate_duplicate_output.._valid)rr4r5)r9rrrrrrr validate_duplicate_output-s   r)+r|collections.abcrrtextwraprkeywordrrZ _groupingrrZdevelopment.base_componentrrNr _utilsr r r r rr!rr(r)r;rErKrxrrrrrrrrrrrrrrrrr s>       "0   *