U f{jL2@sZdZddlmZddlZddlZddlZddlmZddlZddl m Z m Z ddl m Z ddlZddlZddlmZddlZddlZdd lmZmZdd lmZd d lmZmZmZd4ddZd5ddZddZ GdddZ!Gddde"Z#ddZ$ddZ%ed6d d!Z&ed7d#d$Z'd8d&d'Z(d(d)Z)d*d+Z*d,d-Z+d.d/Z,d9d0d1Z-d2d3Z.dS):z%Some miscellaneous utility functions.)contextmanagerN)log)QueueEmpty) Formatter)Thread) _check_option_validate_type) _get_args)loggerverbosewarnscCs,t|ttjfr|nt|}|dkr(|S|S)z#Determine if plural should be used.r ) isinstanceintnpZgenericlen)xZnon_plplZlen_xrM/var/www/html/bwave/python/venv/lib/python3.8/site-packages/mne/utils/misc.py_plsr> cCs\t\}}}tt|||}d|dt||}d|d||}|S)zExplain an exception.r : )sysexc_info traceback format_list extract_tbjoinsplitformat_exception_only)startstopprefixetypevaluetbstringrrr_explain_exception!s r.cs6t|tddD}fdd|DS)zSort and return keys of dict.cSsg|] }t|qSrstr).0krrr /sz_sort_keys..csg|] }|qSrr)r1iikeysrrr30s)listr6rZargsort)ridxrr5r _sort_keys,s r9c@s"eZdZdZddZdddZdS) _DefaultEventParserzParse none standard events.cCs t|_dSN)dict event_ids)selfrrr__init__7sz_DefaultEventParser.__init__r cCs(||jkr|t|j|j|<|j|Sr;)r=r)r> descriptionoffsetrrr__call__:s z_DefaultEventParser.__call__N)r )__name__ __module__ __qualname____doc__r?rBrrrrr:4sr:c@seZdZdZddZdS) _FormatDictzHelp pformat() work properly.cCs d|dS)N{}r)r>keyrrr __missing__Dsz_FormatDict.__missing__N)rCrDrErFrKrrrrrGAsrGcKst}t|}||d|S)zqFormat a template string partially. Examples -------- >>> pformat("{a}_{b}", a='x') 'x_{b}' r)rrGvformat)tempfmt formattermappingrrrpformatHsrQcCs t|jdD]}||q dS)N)iterreadlineput)outqueuelinerrr_enqueue_outputUsrYFc Osd}d}t}t}t|f||} | j| jtt| j|fd} tt| j|fd} d| _d| _| | | dk } z|j dd} Wnt k rYqYqX| d} t | || 7}qz|j dd}Wnt k rYqYqX| d}t |||7}q| rzq"qzW5QRXW5QRXW5QRX||f}|r\|| jf}nF| jrt|tjj}dt|krt| j||nt| j||S) aRun command using subprocess.Popen. Run command and wait for command to complete. If the return code was zero then return, otherwise raise CalledProcessError. By default, this will also add stdout= and stderr=subproces.PIPE to the call to Popen to suppress printing to the terminal. Parameters ---------- command : list of str | str Command to run as subprocess (see subprocess.Popen documentation). return_code : bool If True, return the return code instead of raising an error if it's non-zero. .. versionadded:: 0.20 %(verbose)s *args, **kwargs : arguments Additional arguments to pass to subprocess.Popen. Returns ------- stdout : str Stdout returned by the process. stderr : str Stderr returned by the process. code : int The return code, only returned if ``return_code == True``. r)targetargsTNg{Gz?)timeoutzutf-8output)rrunning_subprocessstdoutstderrrrYdaemonr'pollgetrdecoder infowarning returncodeprint subprocessCalledProcessErrorr?r )commandZ return_coderr[kwargsZall_outZall_errZout_qZerr_qpZout_tZerr_tZdo_breakrVerrr]Zerr_funrrrrun_subprocessZsL&         $rowaitc osJt|tdtd|ddddgdtjgdtjgfD]\}}||kr4tj||<q4|dt j }t d d |d  t j Drtd t|tr|}n"d d|D}ddd |D}td|ztj|f||} WnHtk r"t|tr| d} n|d} td| YnXz | VW5t| || XdS)aContext manager to do something with a command running via Popen. Parameters ---------- command : list of str | str Command to run as subprocess (see :class:`python:subprocess.Popen`). after : str Can be: - "wait" to use :meth:`~python:subprocess.Popen.wait` - "communicate" to use :meth:`~python.subprocess.Popen.communicate` - "terminate" to use :meth:`~python:subprocess.Popen.terminate` - "kill" to use :meth:`~python:subprocess.Popen.kill` %(verbose)s *args, **kwargs : arguments Additional arguments to pass to subprocess.Popen. Returns ------- p : instance of Popen The process. afterrp terminatekill communicater`r_envcss|]}|dVqdS)~N) startswith)r1rmrrr sz%running_subprocess..PATHzYour PATH environment variable contains at least one path starting with a tilde ("~") character. Such paths are not interpreted correctly from within Python. It is recommended that you use "$HOME" instead of "~".cSsg|] }t|qSrr/r1rrrrr3sz&running_subprocess.. css|] }|VqdSr;rrzrrrrxszRunning subprocess: %srzCommand not found: %sN)r r0r rr`r_riPIPErcosenvironanyr%pathseprrr$r rePopen Exceptionerrorgetattrrp) rkrqrr[rlZstdxxxZ sys_stdxxxruZ command_strrm command_namerrrr^s2      r^TcCsdg}|D]V}d|kr$|r$|dd}d|kr>|r>|dd}|drT|dd}||q|S)aRemove white-space on topo matching. This function handles different naming conventions for old VS new VectorView systems (`remove_whitespace`). Also it allows to remove system specific parts in CTF channel names (`before_dash`). Usage ----- # for new VectorView (only inside layout) ch_names = _clean_names(epochs.ch_names, remove_whitespace=True) # for CTF ch_names = _clean_names(epochs.ch_names, before_dash=True) r{r-r_vN)replacer%endswithappend)namesZremove_whitespaceZ before_dashcleanednamerrr _clean_namess      rcCst}zFtdD] }|j}q|jj}t|ds:WdSt|\}}}}W5~Xt}|D]}||||<q^| dd|S)z>Return all arguments (except self) and values of read_raw_xxx.z */mne/io/*Nr>) inspect currentframerangef_backf_code co_filenamefnmatch getargvaluesr<pop)frame_fnamer[valuesparamsargrrr_get_argvalues s   rcCsddddddg}dddd d d g}|dkrxttt|d t|d}t|d |}||}||}d |}|||S|dkrd S|dkrd SdS)zTurn number of bytes into human-readable str. Parameters ---------- num : int The number of bytes. Returns ------- size : str The size in human-readable format. byteskBMBGBTBPBrr riz {0:.%sf} {1}z0 bytesz1 byteN)minrrrfloatformat)numZunitsZdecimalsexponentZquotientunitZ num_decimals format_stringrrr sizeof_fmt#s  rcstfdddDS)Nc3s|]}tt|dVqdSr;)callabler)r1robjrrrxFsz_file_like..)readseek)allrrrr _file_like?srcCs(|j}|j}|dkr|jS|d|jS)Nbuiltins.) __class__rDrE)rklassmodulerrr _fullnameIs rc Csd}d}t}tt}|D]}zt||}Wntk rNd}YnX|r|jdkrx|dt|ddt |}d} |D]$} | |k r| t k r| t k rt | st| ttfr,dt| } t | } dd | D} d ttd d | D} | d t| d | 7} ~ n^t| dddd} | drz"| dt| jddd7} Wntk rYnXt| }||d| | d7} ~ q~|| dk7}~q"~t|dkstd|d|jd|dd|dS)NTrFZBrainzBrain._cleaned = Z_cleanedzlen=css|]}t|VqdSr;)rr1rrrrrxjsz'_assert_no_instances../css|]}|dk r|VqdSr;rrrrrrxksz, z referrers: drr{z sD          V <   2