U ZfX@sddlmZddlZddlZddlmZmZddlmZddl m Z ddl m Z ddl mZmZdd lmZd+d d Zd,d d ZddZddZd-ddZddZd.ddZddZddZddZddZd d!Zd/d#d$Zd%d&Zd'd(Z d0d)d*Z!dS)1) OrderedDictN)filldedent)_explicitize_argsNonExistentEventException)python_keywords) collect_nodesfilter_base_nodes) Componentcsd}|dk r||ks$|dk r,d|kr,tn tt}tt}tttt|} t||||d dd} t |} d| k} dd | D} t t} dkrd| kr| dd }d }d }n d }d}d}t | dkrd }n d| d}| r|d7}fdd | D}|rT|dkr,dnd}t ||krT|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).0argrrN/tmp/pip-unpacked-wheel-47crqvv_/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|]B}|ds|tkr|dkr|dr:|ddn |ddqS)z-*ZsetPropsrequiredsz=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_validationZchildren_propsZ base_nodes) filter_props reorder_propsreprparse_wildcardslistmapstrkeyscreate_docstringreplacerequired_propsprohibit_eventsremovelenjoinr itemsrformatr )r$rrr%r max_propscr&Zwildcard_prefixesr(r)Z required_argsZis_children_requiredZ prop_keysr*r+r,r-Zdefault_arglistZfinal_max_propsZnodesrrrgenerate_class_strings%          rAc Cspd}t||||||}|dd}tj||} t| ddd} | || |W5QRXtd|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-8encodingz Generated N)rAospathr<openwriteprint) r$rrr%rr?Z import_stringZ class_string file_name file_pathfrrrgenerate_class_files   rNc Csjttj|ddddH}ddd|D}dd d|D}|d |d }||W5QRXdS) Nz _imports_.pyrBrCrDrcss|]}d|d|VqdS)zfrom .z import Nrrxrrr sz#generate_imports..z, css|]}d|dVqdS)z ""NrrOrrrrQsz __all__ = [ z ])rHrFrGr<rI)project_shortname componentsrMZcomponent_importsZall_listZimports_stringrrrgenerate_importss rUcGs\g}|D]J\}}|dddd}|||D]}|||d|d|q:q |S)N/.rrr)r=splitappend)rSmetadataZcomponent_generatorsrTZcomponent_pathZcomponent_datar generatorrrrgenerate_classes_filess r]cCs0t|||||}ttd}t||||}|S)zGenerate a Python class object given a class string. Parameters ---------- typename props description namespace Returns ------- )r r)rAr rexec)r$rrr%rstringZscoperesultrrrgenerate_classs   racCsddt|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..)r2r=rrrrr8s r8cCs||dk r||ks |dk r$d|kr$|nt|}|ddkr@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 rZaeiounrrc ssV|]N\}}t|d|kr|dn|d|d|d|ddd|koHd|kdVqdS)typeflowTyperr defaultValuerrc type_objectrrdefault indent_num is_flow_typeNcreate_prop_docstringget)rrrdrrrrQ$s z#create_docstring..A z component. z Keyword arguments: )r/lowerr<r.r=)rrrrrer+rrrr6 s   r6cCsd|ksd|krtddS)zEvents have been removed. Raise an error if we see dashEvents or fireEvents. Parameters ---------- props: dict Dictionary with {propName: propMetadata} structure Raises ------- ? Z dashEventsZ fireEventsziEvents are no longer supported by dash. Use properties instead, eg `n_clicks` instead of a `click` event.Nrrrrrr96s r9cCs,g}dD]}||kr||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-*NrW)rZ)rr'Z wildcard_attrrrrr1Hs r1cCs@d|krdgng}d|kr dgng}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)rtr)rsortedr2r=)rZprops1Zprops2rrrr/Zsr/cCst|}t|D]\}}d|kr:d|kr:||qd|krb|dd}|dkr||qd|kr|dd}|dkrd|dks|dddkr||qtq|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) ``` rfrgname> instanceOfsymbolfunc signatureobject)copydeepcopyr2r=pop ValueError)rr&Zarg_namerZarg_typeZ arg_type_namerrrr.os *      r.cCs.dddd}|D]\}}|||}q|S)zM replaces javascript keywords true, false, null with Python keywords TrueFalseNone)truefalsenull)r=r7)txtZfix_wordZ js_keywordZpython_keywordrrr fix_keywordss rFcCst|||d}d|}|r"|dnd}t|}d} |r.z- z (z; )z ) js_to_py_typerr7stripr startswith partitionrYr<lstripfindr; splitlines)rcrjrrrkrlrmZ py_type_nameZindent_spacingZ is_requiredZperiodZ desc_indentcolonZ dict_or_listZintro1Zintro2Z dict_descrZintroZ dict_part1Z dict_part2current_indenttnrrrrosd"      .rocsfdd}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<|]4\}}t|||d|dd|dddVqdS)rrrrh)rcrjrrrkrlNrnrbrlrrrQ's  zHmap_js_to_py_types_prop_types..shape_or_exact..r)r<rur2r=rrlrjrrshape_or_exact&s z5map_js_to_py_types_prop_types..shape_or_exactcs@td}|r.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_ofcSsdSNr2rrrrrBz/map_js_to_py_types_prop_types..cSsdSNbooleanrrrrrrCrcSsdSNnumberrrrrrrDrcSsdSNr_rrrrrrErcSsdSNrrrrrrrFrcSsdS)Nz'boolean | number | string | dict | listrrrrrrGrcSsdSNzdash componentrrrrrrHrcSsdSNz8a list of or a singular dash component, string or numberrrrrrrIrcsdddddDS)Nza value equal to: r css|]}t|dVqdS)rN)r4)rtrrrrQMsBmap_js_to_py_types_prop_types....rr<rrrrrKscsddddDS)N | css"|]}t|dkrt|VqdSrNrrZsubTyperrrrQPs rrrrrrrrPs csdtdS)Nz-dict with strings as keys and values of type rrrrrrrXs )arrayboolrr_r{anyrnodeenumunionZarrayOfZobjectOfshapeexacttupler)rjrlrrrrrrmap_js_to_py_types_prop_types#s(    rcsVtddddddddddddddd dfd dfd dfd dd S)z2Mapping from the Flow js types to the Python type.cSsdSrrrrrrrgrz/map_js_to_py_types_flow_types..cSsdSrrrrrrrhrcSsdSrrrrrrrircSsdSrrrrrrrjrcSsdSrrrrrrrkrcSsdS)Nz!bool | number | str | dict | listrrrrrrlrcSsdSrrrrrrrmrcSsdSrrrrrrrnrcsddddDS)Nrcss"|]}t|dkrt|VqdSrrrrrrrQps Bmap_js_to_py_types_flow_types....rrrrrrrps cs4dtdddkr.dtdddndS)Nr2rrrz of rrrrrrrvscs$ddfddddDS)Nrrc 3sJ|]B}t|d|d|dd|ddd|ddddVqd S) keyrrrrrhrTriNrn)rrdrrrrQs  rrzZ propertiesrrrrrr}s  ) rrrr_ZObjectrElementNoderArrayrzrrrrrmap_js_to_py_types_flow_typesds   rcCsp|d}|rt|dn t||d}d|kr2|dsB|dddkrFdS||krl|dkrb|||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 rvr)rjrlZcomputedrfrfunctionrz)rrrp)rjrmrlZ js_type_nameZjs_to_py_typesrrrrs(    r)NN)NN)N)N)F)Fr)" collectionsrr|rFtextwraprrZdash.development.base_componentrZdash.exceptionsrZ _all_keywordsr Z_collect_nodesr r Zbase_componentr rArNrUr]rar8r6r9r1r/r.rrorrrrrrrs>       &   -D dA+