B dH@svdZddlZddlZddlZddlZddlmZddlmZej de dddd d Z dddZ ddZ dddZdS)zH mpld3 Utilities =============== Utility routines for the mpld3 package N)wraps)urlsalwaysZmpld3)categorymoduleFcCs&|rtd| Sttd|SdS)zxCheck whether objid is valid as an HTML id attribute. If html5 == True, then use the more liberal html5 rules. z\sz^[a-zA-Z][a-zA-Z0-9\-\.\:\_]*$N)researchboolmatch)objidhtml5rX/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/mpld3/utils.py html_id_oksrelTcCsJ|sd}|sd}|tttt||}|rFt|sFtd|S)zGet a unique id for the objectrz5"{0}" is not a valid html ID. This may cause problems)strosgetpididrwarningswarn)objsuffixprefixZwarn_on_invalidr rrrget_ids   rcs0tfdd}df|j|_|S)z*Decorator to mark functions as deprecated.cs tjdtd||S)Nz7{0} is deprecated and will be removed. Use {1} instead)r)rrformatDeprecationWarning)argskwargs)funcnew_nameold_namerrnew_func.szdeprecated..new_funcz(*%s is deprecated: use %s instead* )r__doc__)r!r#r"r$r)r!r"r#r deprecated,sr&c s|dkr@yddlmWn tk r8t}d}YqDXd}nd}|dkrRtj}|dkr`tj}tj |}tj |}tj |st d |tj |st d ||rVd}fd d }y|||gWnt k rRdd lm}tj|d } x@||gD]4} tj| tj | } tj | r t| q W|||gYnXnd }tj||} tj||} xj|| f|| fgD]V\} } yt| | Wn:t k rtj | rt| t| | YnXqW||||fS)a Write the mpld3 and d3 javascript libraries to the given file location. This utility is used by the IPython notebook tools to enable easy use of mpld3 with no web connection. Parameters ---------- location : string (optioal) the directory in which the d3 and mpld3 javascript libraries will be written. If not specified, the IPython nbextensions directory will be used. If IPython doesn't support nbextensions (< 2.0), the current working directory will be used. d3_src : string (optional) the source location of the d3 library. If not specified, the standard path in mpld3.urls.D3_LOCAL will be used. mpld3_src : string (optional) the source location of the mpld3 library. If not specified, the standard path in mpld3.urls.MPLD3_LOCAL will be used. Returns ------- d3_url, mpld3_url : string The URLs to be used for loading these js files. Nr)install_nbextensionFTzd3 src not found at '{0}'zmpld3 src not found at '{0}'z/nbextensions/cs:ddl}|jddkr.x|D] }|qWn|dS)z-Wrapper for IPython.html.install_nbextension.rN)IPython version_info) extensionsr) extension)r'rr_install_nbextensionps  z2write_ipynb_local_js.._install_nbextension)get_ipython_dirZ nbextensionsz/files/)Z IPython.htmlr' ImportErrorrgetcwdrZD3_LOCALZ MPLD3_LOCALpathbasenameexists ValueErrorrIOErrorZIPython.utils.pathr.joinremoveshutilcopyfile)locationZd3_srcZ mpld3_srcZ nbextensionZd3jsZmpld3jsrr-r.ZnbextsrcdestZd3_destZ mpld3_destr)r'rwrite_ipynb_local_js9sT        r=)F)rrT)NNN)r%rrr8r functoolsrrrfilterwarningsrrrr&r=rrrrs