o dX@sddlmZddlZddlZddlmZmZddlmZddl m Z ddl m Z ddl mZmZdd lmZ  d+d d Z  d+d d ZddZddZ d,ddZddZd,ddZddZddZddZddZd d!Z "d-d#d$Zd%d&Zd'd(Z d.d)d*Z!dS)/) OrderedDictN)filldedent)_explicitize_argsNonExistentEventException)python_keywords) collect_nodesfilter_base_nodes) Componentcsd}|dur ||vs|durd|vrtntt}tt}tttt|} t||||d dd} t |} d| v} dd | D} t t} dvrfd| vrf| dd }d }d }nd }d}d}t | dkrud }nd| d}| r|d7}fdd | D}|r|dvrdnd}t ||kr|d|}| d7} |d|dg7}tddD}t|j||||| | |||||t|dgd 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  childrencSsg|]}|dkr|qSr).0argrro/var/www/html/visualizacion-main/env/lib/python3.10/site-packages/dash/development/_py_components_generation.py Ysz)generate_class_string..zchildren=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.') csJg|]!}|ds|tvr|dkr|dr|ddn|ddqS)z-*setPropsrequiredsz=Component.REQUIREDz=Component.UNDEFINED)endswithr )rprrrrys  rz 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**kwargscSsi|] \}}|dkr||qSrr)rkvrrr sz)generate_class_string..) 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_keysr+r,r-r.default_arglistfinal_max_propsnodesrr rgenerate_class_strings%          rKc Csd}t||||||}|dd}tj||} t| ddd} | || |Wdn1s4wYtd|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 rz.pywutf-8encodingNz Generated )rKospathr?openwriteprint) r%rrr&rrB import_string class_string file_name file_pathfrrrgenerate_class_files    rZcCsttj|dddd*}ddd|D}dd d|D}|d |d }||WddS1s9wYdS) Nz _imports_.pyrLrMrNrcss |] }d|d|VqdS)zfrom .z import Nrrxrrr sz#generate_imports..z, css|] }d|dVqdS)z ""Nrr[rrrr]z __all__ = [ z ])rRrPrQr?rS)project_shortname componentsrYcomponent_importsall_listimports_stringrrrgenerate_importss "recGs\g}|D]%\}}|dddd}|||D] }|||d|d|qq|S)N/.rrr)r@splitappend)r`metadatacomponent_generatorsracomponent_pathcomponent_datar generatorrrrgenerate_classes_filess rpcCs0t|||||}ttd}t||||}|S)zGenerate a Python class object given a class string. Parameters ---------- typename props description namespace Returns ------- )r r)rKr rexec)r%rrr&rstringscoperesultrrrgenerate_classs   rucCsddt|DS)zPull names of required props from the props object. Parameters ---------- props: dict Returns ------- list List of prop names (str) that are required for the Component cSsg|] \}}|dr|qS)rrr prop_nameproprrrrsz"required_props..)r5r@r rrrr;s r;cCs||dur||vs|durd|vr|nt|}|ddvr dnd}ddd t|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 Nr raeiounrrc ssX|]'\}}t|d|vr|dn|d|d|d|ddd|vo%d|vdVqdS)typeflowTyperr defaultValuerrw type_objectrrdefault indent_num is_flow_typeNcreate_prop_docstringget)rrrxrrrr]$s  z#create_docstring..A z component. z Keyword arguments: )r2lowerr?r1r@)rrrrrzr,rrrr9 s   r9cCsd|vsd|vr tddS)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.Nrr rrrr<6s  r<cCs,g}dD]}||vr||ddq|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-*Nrg)rj)rr( wildcard_attrrrrr4Hs  r4cCs@d|vrdgng}d|vrdgng}t||tt|S)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)rsortedr5r@)rprops1props2rrrr2Zsr2cCst|}t|D]I\}}d|vrd|vr||q d|vr1|dd}|dvr0||q d|vrS|dd}|dkrRd|dvsM|dddkrR||q 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) ``` r{r|name>funcsymbol instanceOf signatureobject)copydeepcopyr5r@pop ValueError)rr'arg_namerarg_type arg_type_namerrrr1os$ *     r1cCs.dddd}|D] \}}|||}q |S)zM replaces javascript keywords true, false, null with Python keywords TrueFalseNone)truefalsenull)r@r:)txtfix_word js_keywordpython_keywordrrr fix_keywordss rFcCst|||d}d|}|r|dnd}t|}d} |rd} n|r,|dvr,d|d d} |r0d nd} |d d d | }|d } t|| | ddd}|rSd |nd}|rYdnd} t|}d |vr|drjdnd} |d\}}}d|d||}t|| | ddd}d|vr|dd\}}d| d|g}|d|}| d  d}|t |krddd| 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 rrhr^z\"z F)initial_indentsubsequent_indentbreak_long_wordsbreak_on_hyphens:r5z list of dictsdictz with keys:`z` is a z| dict with keys:z |rOrz -css |] }|dkrd|VqdS)rz Nr)rlinerrrr]s  z(create_prop_docstring..z- z (z; )z ) js_to_py_typerr:stripr startswith partitionrir?lstripfindr> splitlines)rwrrrrrr py_type_nameindent_spacing is_requiredperiod desc_indentcolon dict_or_listintro1intro2 dict_descrintro dict_part1 dict_part2current_indenttnrrrrsl"      $rcsfdd}fdd}fdd}tddd dd dd dd dd dddddfddfdd|fdd|||dS)z=Mapping from the PropTypes js type object to the Python type.cs,ddfddttdDS)Ndict with keys: rc 3s>|]\}}t|||d|dd|dddVqdS)rrrr})rwrrrrrNrrvrrrr]'s   zHmap_js_to_py_types_prop_types..shape_or_exact..r)r?rr5r@rrrrrshape_or_exact&s z5map_js_to_py_types_prop_types..shape_or_exactcsBtd}|rd|dddkr|dS|dddSd S) Nrlist of rrrrdictsrr5)rrir:)innerrrrarray_of3s  z/map_js_to_py_types_prop_types..array_ofcs.dddD}dt|dd|dS)NcSsg|]}t|qSrr)relementrrrr>szCmap_js_to_py_types_prop_types..tuple_of..elementsrz elements: [r!])r>r?)rrrrtuple_of=sz/map_js_to_py_types_prop_types..tuple_ofcSdSNr5rrrrrBz/map_js_to_py_types_prop_types..cSrNbooleanrrrrrrCrcSrNnumberrrrrrrDrcSrNrrrrrrrrErcSrNrrrrrrrFrcSr)Nz'boolean | number | string | dict | listrrrrrrGrcSrNzdash componentrrrrrrHrcSrNz8a list of or a singular dash component, string or numberrrrrrrIrcsdddddDS)Nza value equal to: r!css|] }t|dVqdS)rN)r7)rtrrrr]Mr_Bmap_js_to_py_types_prop_types....rr?rrrrrKscddddDS)N | cs$|] }t|dkrt|VqdSrNrrsubTyperrrr]P  rrrrrrrrP csdtdS)Nz-dict with strings as keys and values of type rrrrrrrXs )arrayboolrrrranyrnodeenumunionarrayOfobjectOfshapeexacttupler)rrrrrrrrmap_js_to_py_types_prop_types#s(    rcsVtddddddddddddddd dfd dfd dfd dd S)z2Mapping from the Flow js types to the Python type.cSrrrrrrrrgrz/map_js_to_py_types_flow_types..cSrrrrrrrrhrcSrrrrrrrrircSrrrrrrrrjrcSrrrrrrrrkrcSr)Nz!bool | number | str | dict | listrrrrrrlrcSrrrrrrrrmrcSrrrrrrrrnrcr)Nrcsrrrrrrrr]prBmap_js_to_py_types_flow_types....rrrrrrrprcs6dtdddkrdtdddSdS)Nr5rrrz of rrrrrrrvs cs$ddfddddDS)Nrrc 3sL|]!}t|d|d|dd|ddd|ddddVqd S) keyrrrrr}rTr~Nr)rrxrrrr]s   rr propertiesrrrrrr}s  ) rrrrrObjectrElementNoderArrayrrrrrrmap_js_to_py_types_flow_typesds   rcCsp|d}|r t|dnt||d}d|vr|ds!|dddkr#dS||vr6|dkr1|||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)rrcomputedr{rfunctionr)rrr)rrr js_type_namejs_to_py_typesrrrrs&    r)NN)N)F)Fr)" collectionsrrrPtextwraprrdash.development.base_componentrdash.exceptionsr _all_keywordsr _collect_nodesr r base_componentr rKrZrerprur;r9r<r4r2r1rrrrrrrrrs@        &   -D dA+