a Df.@sdZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z ddl Z ddl mZddlmZddlmZmZd d lmZGd d d e jZGd ddeZdS)z The Terminal Widget makes it easy to create Panel Applications with Terminals. - For example apps which streams the output of processes or logs. - For example apps which provide interactive bash, python or ipython terminals ) annotationsN)ClassVarMapping) JupyterComm)PeriodicCallback) edit_readonly lazy_load)WidgetcsheZdZdZejeefddZej dddZ ej ddZ ej d dd d Zejd d dZejd ddZejddZejeddZejdddZejdd ddZejd dZejddZfddZeddZddZddZejd d!dd"d#d$Z d%d&Z!d'd(Z"ed)d*Z#d;d,d-Z$d.d/Z%d0d1Z&ejd2dd"d3d4Z'ejd5dd"d6d7Z(dFz-TerminalSubprocess._quote..)join)commandrrr _quoteDszTerminalSubprocess._quotecs4t|tr|St|tr0fdd|DS|S)Ncsg|]}|qSr)r*)r$argrrr r&Lr'z2TerminalSubprocess._clean_args..) isinstancestrr*listrargsrr,r _clean_argsHs    zTerminalSubprocess._clean_argsc Os6ddl}|s|j}|std|jr,td||}|jrJi|j|}|\}}|dkrz"tj|fi|}t t |Wn4t y}zt t |dWYd}~n d}~00nz||_ ||_ |t|j|jd|_|j|jjj|jddd |_t|d |_Wdn1s(0YdS) z, Runs a subprocess command. rNzError. No args providedz@Error. A child process is already running. Cannot start another.z& CompletedProcess('FileNotFoundError'))callbackperiodvalueF)Z onlychangedT)ptyr1 ValueErrorrunningr2rfork subprocessrunprintr.FileNotFoundError _child_pid_fd _set_winsizer&_forward_subprocess_output_to_terminal_period_periodic_callbackstartrparamwatch%_forward_terminal_input_to_subprocess_watcher edit_constant)rr1rr6 child_pidfdresulterrr r;OsB  (  zTerminalSubprocess.runz_terminal.ncolsz_terminal.nrowsrFcCs~|jdus|jjr|jjsdSddl}ddl}ddl}|d|jj|jjdd}z||j|j |Wnt yxYn0dS)NrZHHHH) r?rnrowsncolsfcntlstructtermiospackZioctl TIOCSWINSZOSError)rrQrRrSZwinsizerrr r@s zTerminalSubprocess._set_winsizecGsL|j}||r_resetoskillpggetpgidsignalSIGTERMrwrite)reventsrJrrr rs zTerminalSubprocess._killcCsld|_d|_|jr"|jd|_|jr8|jj|jt|d|_ Wdn1s^0YdS)NrF) r?r>rCstoprHrrEZunwatchrIr8r,rrr rWs  zTerminalSubprocess._resetcCs|d|dSNCompletedProcess)rfind)r5rrr _remove_last_line_from_stringsz0TerminalSubprocess._remove_last_line_from_stringrc Cs^t||}t|dD]8}z|dWStyN|t|d}Yq0qtddS)zHUTF-8 characters can be multi-byte so need to decode on correct boundaryr zutf-8z(Could not find decode boundary for UTF-8N)rXreadrangedecodeUnicodeDecodeError UnicodeError)rrKZmax_read_bytesZmax_extra_bytesdata_rrr _decode_utf8_on_boundarys  z+TerminalSubprocess._decode_utf8_on_boundarycCsh|js dSt|jggg|j\}}}|s.dS||j|j}d|vrX|||}|j|dSr`) r?select _timeout_secrk_max_read_bytesrWrcrr])rZ data_readyrjoutputrrr rAs z9TerminalSubprocess._forward_subprocess_output_to_terminalcGs |jrt|j|jjdSN)r?rXr]rr5encoderr^rrr rGsz8TerminalSubprocess._forward_terminal_input_to_subprocessr1cCs6|j}t|tr2d|vr2td|d|ddS)N z The args 'zV' provided contains spaces. They must instead be provided as the list )r1r-r.r7splitr0rrr _validate_argssz!TerminalSubprocess._validate_argsrBcCs|jr|j|j_dSrp)rCrBr4r,rrr _update_periodic_callbacksz,TerminalSubprocess._update_periodic_callbackNcCsd|jd|jdS)NzTerminalSubprocess(args=z , running=))r1r8rdepthrrr __repr__szTerminalSubprocess.__repr__)r)N)+__name__ __module__ __qualname____doc__rEZ ClassSelectorr.r/r1ActionrDictrBooleanr8Integerr>r?rnrrCrB ParameterrrmrHr staticmethodr*r2r;dependsr@rrWrcrkrArGrurvrz __classcell__rrrr r s@      9         r csfeZdZUdZejdddZejidddZej dd d Z ej dd d Z ej dd d Z ej ddddZejddd Zej ddZej ddZdddddddZded<dAfdd ZddZdBfdd Zd!d"Zd#d$Zejd%dd&d'd(ZdCd)d*Zed+d,Zed-d.Zd/d0Z d1d2Z!d3d4Z"d5d6Z#dDd7d8Z$dEd9d:Z%d;d<Z&d=d>Z'd?d@Z(Z)S)FTerminala The `Terminal` widget renders a live terminal in the browser using the xterm.js library making it possible to display logs or even provide an interactive terminal in a Panel application. Reference: https://panel.holoviz.org/reference/widgets/Terminal.html :Example: >>> Terminal( ... "Welcome to the Panel Terminal!", options={"cursorBlink": True} ... ) zClears the Terminal.Trz Initial Options for the Terminal Constructor. cf. https://xtermjs.org/docs/api/terminal/interfaces/iterminaloptions/)r precedencerr!z. System output written to the Terminalrz/ The number of columns in the terminal.)readonlyrz, The number of rows in the terminal.ZInputzO User input received from the Terminal. Sent one character at the time.)labelrrFz7 Whether or not to write to the server console.z$Sends a signal to clear the terminalrrNro)clearnamero_outputr5write_to_consolez"ClassVar[Mapping[str, str | None]]_renamec s:|pd|d<}|j|d<tjfd|i|d|_dS)Nr!rrro)_clearrr _subprocess)rroparamsrrr r s zTerminal.__init__cCs`|}t|tr|}nt|tr*|d}nt|}|j|krBd|_||_|j|7_t|jS)Nutf8r!)r-r.bytesrfrrolen)rZ _Terminal__scleanedrrr r]s    zTerminal.writecsP|jdur tddt|t||_t||||}|j|_|jd|||d|S)Nzpanel.models.terminalrZ keystroke)modelrcomm)Z _widget_typer r-rr _get_modelroZ_register_events)rrrootparentrrrrr r!s zTerminal._get_modelc Csdt|H|j|_t|d|_Wdn1s80YWdn1sV0YdS)Nr!)rkeyr5rEZdiscard_events)reventrrr _process_event+s  zTerminal._process_eventcGsd|_|jd7_dS)z4 Clears all output on the terminal. r!r N)ro_clearsrrrrr r1szTerminal._clearrrNcCs|jrtj|jdSrp)rsys __stdout__r]rr,rrr _write8szTerminal._writecCsdt|dS)Nz Terminal(id=rw)idrxrrr rz=szTerminal.__repr__cCs|jst||_|jS)z The subprocess enables running commands like 'ls', ['ls', '-l'], 'bash', 'python' and 'ipython' in the terminal. )rr r,rrr r:@s zTerminal.subprocesscCsdSNFrr,rrr closedLszTerminal.closedcCsdSNrrr,rrr filenoPszTerminal.filenocCsdSrprr,rrr flushSszTerminal.flushcCs|jSrpror,rrr getvalueVszTerminal.getvaluecCsdSNTrr,rrr readableYszTerminal.readablecCs|dkr|jS|jd|Srr)rsizerrr rd\sz Terminal.readcCsJg}d}|jdD]0}|dkr:||kr:|t|7}qF||q|S)Nr r)rortr getsizeofappend)rhintlinesrlinerrr readlinesas zTerminal.readlinescCsdSrrr,rrr seekablekszTerminal.seekablecCsdSrrr,rrr writablenszTerminal.writablecCs|D]}||qdSrp)r])rrrrrr writelinesqszTerminal.writelines)N)NNN)N)r)r)*r{r|r}r~rErrroptionsStringrorrPrOr5rrrrr__annotations__rr]rrrrrrzpropertyr:rrrrrrdrrrrrrrrr rsD           r)r~ __future__rrXrlr"r[r:rtypingrrrEZ pyviz_commsrZ io.callbacksrutilrr baser Z Parameterizedr rrrrr s     C