MfXddlmZddlZddlZddlmZmZddlmZddl m Z ddl m Z ddl mZmZdd lmZ dd Z dd Zd Zd Z ddZdZddZdZdZdZdZdZ ddZdZdZ ddZ!dS)) OrderedDictN)filldedent)_explicitize_argsNonExistentEventException)python_keywords) collect_nodesfilter_base_nodes) Componentc<d}|||vs|d|vrtntt}tt}tt t t |} t|||| dd} t|} d| v} d| D} tt } dvr d| vr| dd }d }d }nd }d }d}t| dkrd }nd| d}| r|dz }fd| D}|r-|dvrdndz }t||kr|d|}| dz } |d|dgzz }tdD}t#|||||| | |||||t'|dgz S)a;Dynamically generate class strings to have nicely formatted docstrings, keyword arguments, and repr. Inspired by http://jameso.be/2013/08/06/namedtuple.html Parameters ---------- typename props description namespace prop_reorder_exceptions Returns ------- string aclass {typename}(Component): """{docstring}""" _children_props = {children_props} _base_nodes = {base_nodes} _namespace = '{namespace}' _type = '{typename}' @_explicitize_args def __init__(self, {default_argtext}): self._prop_names = {list_of_valid_keys} self._valid_wildcard_attributes = {list_of_valid_wildcard_attr_prefixes} self.available_properties = {list_of_valid_keys} self.available_wildcard_properties = {list_of_valid_wildcard_attr_prefixes} _explicit_args = kwargs.pop('_explicit_args') _locals = locals() _locals.update(kwargs) # For wildcard attrs and excess named props args = {args} {required_validation} super({typename}, self).__init__({argtext}) NALL)component_nameprops descriptionprop_reorder_exceptionsz  childrencg|] }|dk| Sr).0args i/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/dash/development/_py_components_generation.py z)generate_class_string..Ys"GGGSSJ5F5FS5F5F5Fzchildren=None, z:{k: _locals[k] for k in _explicit_args if k != 'children'}zchildren=children, **argsz'{k: _locals[k] for k in _explicit_args}z**argsrz for k in z: if k not in args: raise TypeError( 'Required argument `' + k + '` was not specified.') z if 'children' not in _explicit_args: raise TypeError('Required argument children was not specified.') cg|]@}|ds)|tv |dk&|dr|ddn|ddAS)z-*setPropsrequiredsz=Component.REQUIREDz=Component.UNDEFINED)endswithr )rprs rrz)generate_class_string..ys~ zz$%&_$<$<j Qx # .q ' ' ' ' '----BQrr z Note: due to the large number of props for this component, not all of them appear in the constructor signature, but they may still be used as keyword arguments., z**kwargsc&i|]\}}|dk ||Srr)rkvs r z)generate_class_string..s#MMMDAqQ*__1a___r) typename namespacefiltered_props$list_of_valid_wildcard_attr_prefixeslist_of_valid_keys docstringdefault_argtextargsargtextrequired_validationchildren_props base_nodes) filter_props reorder_propsreprparse_wildcardslistmapstrkeyscreate_docstringreplacerequired_propsprohibit_eventsremovelenjoinr itemsrformatr )r*rrr+r max_propscr,wildcard_prefixesr.r/ required_argsis_children_required prop_keysr0r1r2r3default_arglistfinal_max_propsnodess ` rgenerate_class_stringrPsJ A0 $ /H@W4W4W # /E=T4T4T U<.. / /  _U3344d3sN,?,?,A,A#B#BCCDD  7  gfd  #>22M%6GGMGGGMEUZZ\\""IUz-???$$$+K-8 =Q           O #J%,?,?qqQG   / 1 1-.>.>?O ? ItyyJ    rcJd}t||||||}|dd}tj||} t | dd5} | || |dddn #1swxYwYt d|dS) zGenerate a Python class file (.py) given a class string. Parameters ---------- typename props description namespace prop_reorder_exceptions Returns ------- zp# AUTO GENERATED FILE - DO NOT EDIT from dash.development.base_component import Component, _explicitize_args r"z.pywutf-8encodingNz Generated )rPospathrDopenwriteprint) r*rrr+rrG import_string class_string file_name file_pathfs rgenerate_class_filer`s( / )%i1H)L""""I Y 22I iw / / /1     "y " "#####s+BB  B cNttj|ddd5}dd|D}dd|D}|d |d }||ddddS#1swxYwYdS) Nz _imports_.pyrRrSrTrc3&K|] }d|d|V dS)zfrom .z import Nrrxs r z#generate_imports..s3%R%R!&=q&=&=!&=&=%R%R%R%R%R%Rrz, c3"K|] }d|dV dS)z ""Nrrcs rrez#generate_imports..s*??qlalll??????rz __all__ = [ z ])rXrVrWrDrY)project_shortname componentsr_component_importsall_listimports_strings rgenerate_importsrms   &77w     II%R%Rz%R%R%RRR::??J?????-MMMMM                   sABB!Bcg}|D]m\}}|dddd}|||D]}|||d|d|n|S)N/.rrr)rEsplitappend)rhmetadatacomponent_generatorsricomponent_pathcomponent_datar generators rgenerate_classes_filesrysJ*2..*:*:  &'--c2226<.s& U U U/)TDDT UI U U Ur)r:rErs rr@r@s) V UT%++---@-@ U U UUrc|||vs|d|vr|nt|}|ddvrdnd}ddt|D}d |d |d |d |S) a5Create the Dash component docstring. Parameters ---------- component_name: str Component name props: dict Dictionary with {propName: propMetadata} structure description: str Component description Returns ------- str Dash component docstring Nrraeiounrrc 3K|]T\}}t|d|vr|dn|d|d|d|ddd|vod|vVUdS)typeflowTyper!r defaultValuerr type_objectr!rdefault indent_num is_flow_typeNcreate_prop_docstringget)rr$rs rrez#create_docstring..$s   At (.$V Dr> s& $ /"999 # /E=T4T4T  5 ! ! a &&((G33A 99  $E**0022     D YAXXXX[XXRVXXrc4d|vsd|vrtddS)zEvents have been removed. Raise an error if we see dashEvents or fireEvents. Parameters ---------- props: dict Dictionary with {propName: propMetadata} structure Raises ------- ? dashEvents fireEventsziEvents are no longer supported by dash. Use properties instead, eg `n_clicks` instead of a `click` event.Nrrs rrArA6s8u  5 5' 8   !6 5rcVg}dD]#}||vr||dd$|S)zPull out the wildcard attributes from the Component props. Parameters ---------- props: dict Dictionary with {propName: propMetadata} structure Returns ------- list List of Dash valid wildcard prefixes )zdata-*zaria-*Nrp)rs)rr- wildcard_attrs rr9r9HsJ,.(-LL E ! ! 0 7 7 crc8J K K K //rc d|vrdgng}d|vrdgng}t||ztt|zS)aVIf "children" is in props, then move it to the front to respect dash convention, then 'id', then the remaining props sorted by prop name Parameters ---------- props: dict Dictionary with {propName: propMetadata} structure Returns ------- dict Dictionary with {propName: propMetadata} structure r)rrid)rr)rsortedr:rE)rprops1props2s rr7r7Zs^ $.#6#6  BF!U]]j\\F vU[[]]0C0C)D)DD E EErctj|}t|D]\}}d|vrd|vr||#d|vr(|dd}|dvr||Od|vrF|dd}|dkr1d|dvs|dddkr||t |S)aFilter props from the Component arguments to exclude: - Those without a "type" or a "flowType" field - Those with arg.type.name in {'func', 'symbol', 'instanceOf'} Parameters ---------- props: dict Dictionary with {propName: propMetadata} structure Returns ------- dict Filtered dictionary with {propName: propMetadata} structure Examples -------- ```python prop_args = { 'prop1': { 'type': {'name': 'bool'}, 'required': False, 'description': 'A description', 'flowType': {}, 'defaultValue': {'value': 'false', 'computed': False}, }, 'prop2': {'description': 'A prop without a type'}, 'prop3': { 'type': {'name': 'func'}, 'description': 'A function prop', }, } # filtered_prop_args is now # { # 'prop1': { # 'type': {'name': 'bool'}, # 'required': False, # 'description': 'A description', # 'flowType': {}, # 'defaultValue': {'value': 'false', 'computed': False}, # }, # } filtered_prop_args = filter_props(prop_args) ``` rrname>funcsymbol instanceOf signatureobject)copydeepcopyr:rEpop ValueError)rr,arg_namerarg_type arg_type_names rr6r6os T]5))Nn224455 #   3!6!6   x ( ( (  S==6{6*H;;;""8,,, 3   OF3M ++Z00C OF4Kx4W4W"&&x000  rcrdddd}|D]\}}|||}|S)zM replaces javascript keywords true, false, null with Python keywords TrueFalseNone)truefalsenull)rEr?)txtfix_word js_keywordpython_keywords r fix_keywordsrsK&AAH&.nn&6&666" Nkk*n55 JrFct|||}d|z}|r|dnd}t|}d} |rd} n|r|dvrd|d dz} |rd nd} |d d d | z}|d z} t || | dd}|rd |nd}|rdnd} t|}d |vr|drdnd} |d\}}}d|d||}t || | dd}d|vr8|dd\}}d| d|g}|d|}| d  d}|t|kr1dd| D}d |d|d| d | d!| |d"||S|r|d nd}d |d|d|| d!| | S)#aCreate the Dash component prop docstring. Parameters ---------- prop_name: str Name of the Dash component prop type_object: dict react-docgen-generated prop type dictionary required: bool Component is required? description: str Dash component description default: dict Either None if a default value is not defined, or dict containing the key 'value' that defines a default value for the prop indent_num: int Number of indents to use for the context block (creates 2 spaces for every indent) is_flow_type: bool Does the prop use Flow types? Otherwise, uses PropTypes Returns ------- str Dash component prop docstring )rrrz valueroptionalr!)rz{}z[]zdefault rrqrgz\"z F)initial_indentsubsequent_indentbreak_long_wordsbreak_on_hyphens:r:z list of dictsdictz with keys:`z` is a z| dict with keys:z |r Orz -c3,K|]}|dkd|zVdS)rz Nr)rlines rrez(create_prop_docstring..s5!!&*QS T!!!rz- z (z; )z ) js_to_py_typerr?stripr startswith partitionrrrDlstripfindrC splitlines)rrr!rrrr py_type_nameindent_spacing is_requiredperiod desc_indentcolon dict_or_listintro1intro2 dict_descrintro dict_part1 dict_part2current_indenttns rrrs"D!lzLJ&N")1ggrG7##GK= =W$888 7??4#<#<<  'SSRF##%%++C0088eDDvMK 6)K"% K)4;${$$$K &CCBE{++K |*6*A*A&*I*IUv &2%;%;L%I%I" 6I66f6f66 &)""     * , ,%/%5%5dA%>%> "J +tZ!@AAJ&::j::J$**40055c:: S00 0 0!!.8.C.C.E.E!!!J  ' ' '9 ' '  ' '  ' 'e ' ' ' '$ ' ' !- 4L    "B U U U) U Ur U; U U U U UUrcfd}fd}fd}tdddddd d d fd fd |fd|||S)z=Mapping from the PropTypes js type object to the Python type.c ddfdttdDzS)Ndict with keys: rc 3K|]L\}}t|||d|dd|ddzVMdS)r!rrr)rrr!rrrNr)rrrrs rrezHmap_js_to_py_types_prop_types..shape_or_exact..'s / /  4 "# j) HH]B7700%>     / / / / / / rr)rDrr:rErrsrshape_or_exactz5map_js_to_py_types_prop_types..shape_or_exact&si"TYY / / / / $*${7/C/I/I/K/K*L*L#M#M / / / & &  rctd}|r>d|dddkr|dzn|dddzSd S) Nrlist of rrrr"dictsr r:)rrrr?)innerrs rarray_ofz/map_js_to_py_types_prop_types..array_of3skk'233  ;;s##A&&00 ]]67A66  vrczddD}dt|dd|dS)Nc,g|]}t|Srr)relements rrzCmap_js_to_py_types_prop_types..tuple_of..>s RRRwM'**RRRrelementsrz elements: [r%])rCrD)rrs rtuple_ofz/map_js_to_py_types_prop_types..tuple_of=sFRR+j:QRRRK#h--KKTYYx5H5HKKKKrcdSNr:rrrrz/map_js_to_py_types_prop_types..BfrcdSNbooleanrrrrrz/map_js_to_py_types_prop_types..CsYrcdSNnumberrrrrrz/map_js_to_py_types_prop_types..DxrcdSNr|rrrrrz/map_js_to_py_types_prop_types..ErrcdSNrrrrrrz/map_js_to_py_types_prop_types..FvrcdS)Nz'boolean | number | string | dict | listrrrrrz/map_js_to_py_types_prop_types..Gs=rcdSNzdash componentrrrrrz/map_js_to_py_types_prop_types..H(rcdSNz8a list of or a singular dash component, string or numberrrrrrz/map_js_to_py_types_prop_types..IOrcTddddDzS)Nza value equal to: r%c3@K|]}t|dVdS)rN)r<)rts rrezBmap_js_to_py_types_prop_types....Ms,FFAAgJFFFFFFrrrDrsrrz/map_js_to_py_types_prop_types..Ks4 iiFFW1EFFFFF GrcNdddDS)N | c3ZK|]&}t|dkt|V'dSrNrrsubTypes rrezBmap_js_to_py_types_prop_types....PI! ! W%%++ ' " "++++! ! rrr rsrrz/map_js_to_py_types_prop_types..Ps6ejj! ! &w/! ! !   rc4dtdzS)Nz-dict with strings as keys and values of type rrrsrrz/map_js_to_py_types_prop_types..Xs ;K011 2r)arrayboolrr|ranyrnodeenumunionarrayOfobjectOfshapeexacttupler)rrrrrs`` rmap_js_to_py_types_prop_typesr##s       LLLLL n  ~ = =(( O O            ?    rcZtddddddddfd fd fd  S) z2Mapping from the Flow js types to the Python type.cdSrrrrrrz/map_js_to_py_types_flow_types..grrcdSrrrrrrz/map_js_to_py_types_flow_types..hs rcdSrrrrrrz/map_js_to_py_types_flow_types..irrcdSrrrrrrz/map_js_to_py_types_flow_types..jrrcdSrrrrrrz/map_js_to_py_types_flow_types..krrcdS)Nz!bool | number | str | dict | listrrrrrz/map_js_to_py_types_flow_types..ls7rcdSrrrrrrz/map_js_to_py_types_flow_types..mrrcdSrrrrrrz/map_js_to_py_types_flow_types..nr rcNdddDS)Nrc3ZK|]&}t|dkt|V'dSrrrs rrezBmap_js_to_py_types_flow_types....prrrr rsrrz/map_js_to_py_types_flow_types..ps6ejj! ! &z2! ! !   rcdtdddkrdtdddndzS)Nr:rrrz of r"rrsrrz/map_js_to_py_types_flow_types..vsTf[4Q788B>> @=Z!8!;<< ? ? ? ?  rcfddfdddDzS)Nrrc 3K|]b}t|d|d|dd|ddd|ddzdVcd S) keyrr!rrrrTrNr)rrrs rrezBmap_js_to_py_types_flow_types....s  &"5k $W !']:6 $W 1 1- D D HH^44)A~!%      rr propertiesr rs`rrz/map_js_to_py_types_flow_types..}sT ii    ( 4\B      r) rrrr|ObjectrElementNoderArrayrr"rs`rmap_js_to_py_types_flow_typesr8ds n!!~ 7 7(( O O            /& & & &rc|d}|rt|nt||}d|vr|ds|dddkrdS||vr'|dkr|||S||SdS) aConvert JS types to Python types for the component definition. Parameters ---------- type_object: dict react-docgen-generated prop type dictionary is_flow_type: bool Does the prop use Flow types? Otherwise, uses PropTypes indent_num: int Number of indents to use for the docstring for the prop Returns ------- str Python type string rr)rrcomputedrrfunctionr)r8r#r)rrr js_type_namejs_to_py_typess rrrs v&L  %+>>>> *#     k!!  # " ??62 & &* 4 4r~%% ; & &/>,/ ;; ;+~l+--- 2r)NN)N)F)Fr)" collectionsrrrVtextwraprrdash.development.base_componentrdash.exceptionsr _all_keywordsr _collect_nodesr r base_componentr rPr`rmryrr@r>rAr9r7r6rrr#r8rrrrrEs###### !!!!!!!!======555555******<<<<<<<<%%%%%%! RRRRt! #$#$#$#$L   $FJ. V V V****Z   $000$FFF*AAAH&aVaVaVaVH>>>B(((V$$$$$$r