vJSrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSK r Sr "SS \ R"\R\ 55r"S S \5r"S S \ 5r"SS\5r"SS\ 5rg)aMultiline output for Cloud SDK. This module contains a set of classes that are useful for managing console output that can be updated that spans multiple lines. Currently only SimpleSuffixConsoleOutput is offered which only supports updating the last added message. SimpleSuffixConsoleOutput is basically a collection of semantically distinct messages to be outputted to the console. These messages all have a suffix, and SimpleSuffixConsoleOutput supports updating the suffix of the last added message. Calling UpdateConsole on a SimpleSuffixConsoleOutput will update these messages and any changes to the console. Example usage: # Example for a simple spinner spinner = ['|', '/', '-', '\\'] num_spinner_marks = len(spinner) # Define a ConsoleOutput message output = SimpleSuffixConsoleOutput(sys.stderr) # Add the message you want to be displayed for the spinner and update the # console to show the message. message = sscm.AddMessage('Instance is being created...') output.UpdateConsole() > Instance is being created # Start the spinner by updating the message and then updating the console. for i in range(20): output.UpdateMessage(message, spinner[i % num_spinner_marks]) output.UpdateConsole() time.sleep(0.1) > Instance is being created...| > Instance is being created.../ > ... output.UpdateMessage(message, 'done\n') output.UpdateConsole() > Instance is being created...done )absolute_import)division)unicode_literalsN) console_attrc\rSrSrSrSrSrg) ConsoleOutputKzManages the printing and formatting of multiline console output. It is up to implementations of this metaclass to determine how different messages will added to the output. cg)AUpdates the console output to show any updated or added messages.Nselfs ,lib/googlecloudsdk/core/console/multiline.py UpdateConsoleConsoleOutput.UpdateConsoleRsr N)__name__ __module__ __qualname____firstlineno____doc__r__static_attributes__r rrr r Ks   rr cZ^\rSrSrSrU4SjrS SjrS SjrSrSr Sr S r U=r $) SimpleSuffixConsoleOutputWaA simple, suffix-only implementation of ConsoleOutput. In this context, simple means that only updating the last line is supported. This means that this is supported in all ASCII environments as it only relies on carriage returns ('\r') for modifying output. Suffix-only means that only modifying the ending of messages is supported, either via a detail_message_callback or by modifying the suffix of a SuffixConsoleMessage. c>Xl/UlSUl[R"5Ul[ [U]#5 g)=Constructor. Args: stream: The output stream to write to. rN) _stream _messages_last_print_index threadingLock_locksuperr__init__rstream __class__s rr&"SimpleSuffixConsoleOutput.__init__as5 LDND!DJ #T35rcrUR URUUUS9sSSS5 $!,(df  g=f)aAdds a SuffixConsoleMessage to the SimpleSuffixConsoleOutput object. Args: message: str, The message that will be displayed. detail_message_callback: func() -> str, A no argument function that will be called and the result will be appended to the message on each call to UpdateConsole. indentation_level: int, The indentation level of the message. Each indentation is represented by two spaces. Returns: SuffixConsoleMessage, a message object that can be used to dynamically change the printed message. detail_message_callbackindentation_levelNr$ _AddMessage)rmessager-r.s r AddMessage$SimpleSuffixConsoleOutput.AddMessagems1     "9-/ s( 6ch[UURUUS9nURRU5 U$)Nr,)SuffixConsoleMessagerr append)rr1r-r.console_messages rr0%SimpleSuffixConsoleOutput._AddMessages6* 7+ -O  NN/* rc&U(d [S5eXR;a [S5eUR(aXRS:wa [S5eUR URU5 SSS5 g!,(df  g=f)z5Updates the suffix of the given SuffixConsoleMessage.A message must be passed.8The given message does not belong to this output object.z+Only the last added message can be updated.N) ValueErrorr r$ _UpdateSuffix)rr1 new_suffixs r UpdateMessage'SimpleSuffixConsoleOutput.UpdateMessagesm  2 33nn$  D FF ~~'^^B%77 D EE  J' s 'B BcpUR UR5 SSS5 g!,(df  g=fNr$_UpdateConsolers rr'SimpleSuffixConsoleOutput.UpdateConsole   ' 5cUR(aUR[UR5S- :ahURURSH.nUR5 URR S5 M0 [UR5S- UlURURR5 gg)r r< N)r r!lenPrintrwrite)rr1s rrE(SimpleSuffixConsoleOutput._UpdateConsoles ~~  3t~~#6#: ;~~d&<&$% ( 5 5rrcd\rSrSrSrSSjrSrSSjrSr\ S5r S r S r S r S rS rg)r5z/A suffix-only implementation of ConsoleMessage.NcDX lXlX0l[R"5R 5SS- UlUR S:aSUlX@lXPlSUl UR [U-- S::aSUl SUl /Ul SUl g)aConstructor. Args: message: str, the message that this object represents. stream: The output stream to write to. suffix: str, The suffix that will be appended to the very end of the message. detail_message_callback: func() -> str, A no argument function that will be called and the result will be added after the message and before the suffix on every call to Print(). indentation_level: int, The indentation level of the message. Each indentation is represented by two spaces. rrJFTN)r_message_suffixr ConsoleAttr GetTermSize_console_width_detail_message_callback_level _no_outputINDENTATION_WIDTH _num_lines_lines _has_printed)rr1r(suffixr-r.s rr&SuffixConsoleMessage.__init__sLML'224@@B1EID Qd$;!#KDO 03DDE!KdoDODKDrcd[U[R5(d [S5eXlg)z$Updates the suffix for this message.2expected a string or other character buffer objectN) isinstancesix string_types TypeErrorrV)rras rr>"SuffixConsoleMessage._UpdateSuffixs& fc.. / / J KKLrcURS:XdUR(agUR5nU(dgUR(aU(alSUlUR 5 UR U5Ul[UR 5UlUR HnURU5 M gUR U5n[U5nXPR:a6URRS5 UHnURU5 M OURU5nURU- S::aBXPR- S-nUR 5 USU-SHnURU5 M O5URRS5 UHnURU5 M X@lXPlg)aPrints out the message to the console. The implementation of this function assumes that when called, the cursor position of the terminal is on the same line as the last line that this function printed (and nothing more). The exception for this is if this is the first time that print is being called on this message or if print_all is True. The implementation should also return the cursor to the last line of the printed message. The cursor position in this case should be at the end of printed text to avoid text being overwritten. Args: print_all: bool, if the entire message should be printed instead of just updating the message. rNTrKrJr<) rYr\ GetMessager` _ClearLine_SplitMessageIntoLinesr_rLr^ _WriteLinerrN_GetNumMatchingLines)r print_allr1line new_lines new_num_linesmatching_lineslines_to_prints rrMSuffixConsoleMessage.Printsu a4?? ooG      d oo//8dkDKK(do++$  ++G4I NM& ll$  00;n > )Q .'81< b>123D //$ 4 4 D //$ K#OrcUR(a3UR5nU(aURU-UR-$URUR-$rC)rZrUrV)rdetail_messages rrkSuffixConsoleMessage.GetMessage(sG $$446n }}~- << ==4<< ''rcBUR[UR-- $z=The effective width when the indentation level is considered.rYr]r[rs reffective_width$SuffixConsoleMessage.effective_width/   "3dkk"A BBrcSn[[[U5UR55H nXURU:wa U$US- nM" U$)NrrJ)rangeminrLr^r_)rrrrtis rro)SuffixConsoleMessage._GetNumMatchingLines4sTN 3s9~t7 8 Q ' n9 rc/nSnU[U5:aZURXX0R-5 X0R- nU[U5:a US==S- ss'U[U5:aMZU$)?Converts message into a list of strs, each representing a line.rr<rK)rLr6r})rr1linesposs rrm+SuffixConsoleMessage._SplitMessageIntoLines<so E C G  ll7s#7#7789 ! !!c s7|  b T G  LrcrURRSRSUR-55 gNz {}  rrNformatrYrs rrlSuffixConsoleMessage._ClearLineI(LLxsT-@-@'@ABrcURRUR[-S-U-5 URR 5 gNr)rrNr[r]flushrrqs rrnSuffixConsoleMessage._WriteLineLs8LLt{{%66rMrkpropertyr}rormrlrnrr rrr5r5sM7-/?@(T F$P( C C Crr5cX^\rSrSrSrU4SjrS SjrS SjrSrSr Sr S r S r U=r $) MultilineConsoleOutputiQaAn implementation of ConsoleOutput which supports multiline updates. This means all messages can be updated and actually have their output be updated on the terminal. The main difference between this class and the simple suffix version is that updates here are updates to the entire message as this provides more flexibility. This class accepts messages containing ANSI escape codes. The width calculations will be handled correctly currently only in this class. c>Xl/UlSUl[R"5UlSUlSUl[[U]+5 g)rrFN) rr r!r"r#r$_last_total_lines_may_have_updater%rr&r's rr&MultilineConsoleOutput.__init__]sE LDND!DJD!D $02rcpUR URUUS9sSSS5 $!,(df  g=f)agAdds a MultilineConsoleMessage to the MultilineConsoleOutput object. Args: message: str, The message that will be displayed. indentation_level: int, The indentation level of the message. Each indentation is represented by two spaces. Returns: MultilineConsoleMessage, a message object that can be used to dynamically change the printed message. r.Nr/)rr1r.s rr2!MultilineConsoleOutput.AddMessageks.     -/ s' 5ctSUl[UURUS9nURR U5 U$)NTr)rMultilineConsoleMessagerr r6)rr1r.r7s rr0"MultilineConsoleOutput._AddMessage|s; D- +-O NN/* rcU(d [S5eXR;a [S5eUR URU5 SUlSSS5 g!,(df  g=f)z9Updates the message of the given MultilineConsoleMessage.r:r;TN)r=r r$_UpdateMessager)rr1 new_messages rr@$MultilineConsoleOutput.UpdateMessagesT  2 33nn$  D FF  [)"d s A A)cpUR UR5 SSS5 g!,(df  g=frCrDrs rr$MultilineConsoleOutput.UpdateConsolerGrHc$SRU5$)zEReturns an ANSI control sequences that moves the cursor up num_lines.z[{}A)r)r num_liness r_GetAnsiCursorUpSequence/MultilineConsoleOutput._GetAnsiCursorUpSequences   Y ''rcUR(dgUR(a4URRUR UR55 SnSnUR HinUR nX- nUR(dU(a X#R-nUR5 MKURRSU-5 Mk XlSUlg)r NrFrK) rrrrNrr r has_updatenum_lines_changedrM)r total_linesforce_print_restr1rs rrE%MultilineConsoleOutput._UpdateConsoles     ll66t7M7MNOK>>##ik   /555  4)+,")!Dr)r!rr$rr rr)rrrrrr&r2r0r@rrrErrPrQs@rrrQs0  3/" #(""rrc\rSrSrSrSSjr\S5r\S5r\S5r \S5r Sr S r S r \S 5rS rS rSrg)riz-A multiline implementation of ConsoleMessage.crX l[R"5UlURR 5SS- UlUR S:aSUlX0lSUlUR [U-- S::aSUlSUl /Ul SUl SUl URU5 g)zConstructor. Args: message: str, the message that this object represents. stream: The output stream to write to. indentation_level: int, The indentation level of the message. Each indentation is represented by two spaces. rrJFTN)rrGetConsoleAttr _console_attrrXrYr[r\r]rUr_ _has_update_num_lines_changedr)rr1r(r.s rr& MultilineConsoleMessage.__init__sL &446D,,88:1=AD Qd#KDO 03DDE!KdoDMDKD#D rcUR$rC)r_rs rrMultilineConsoleMessage.liness ;;rc,[UR5$rC)rLr_rs rr!MultilineConsoleMessage.num_liness t{{ rcUR$rC)rrs rr"MultilineConsoleMessage.has_updates   rcUR$rC)rrs rr)MultilineConsoleMessage.num_lines_changeds  " ""rcZ[U[R5(d [S5eXR:warXlUR (ag[ UR5nURUR5UlSUl U[ UR5:gUl gg)z,Updates the message for this Message object.rdNT) rerfrgrhrUr\rLr_rmrr)rr num_old_liness rr&MultilineConsoleMessage._UpdateMessages k3#3#3 4 4 J KKmm#!m $++&m// >dkd -T[[1A Ad$rcURRXR5n[[ U55HnX#==S- ss'M U$)rrK)r SplitLiner}rrL)rr1rrs rrm.MultilineConsoleMessage._SplitMessageIntoLinessB    ( (2F2F GE 3u:  h$h LrcUR(agURH$nUR5 URU5 M& SUlg)zPrints out the message to the console. The implementation of this function assumes that when called, the cursor position of the terminal is where the message should start printing. NF)r\r_rlrnrrs rrMMultilineConsoleMessage.Prints<     oo oodDrcBUR[UR-- $r{r|rs rr}'MultilineConsoleMessage.effective_width rrcrURRSRSUR-55 grrrs rrl"MultilineConsoleMessage._ClearLinerrchURRUR[-S-U-5 gr)rrNr[r]rs rrn"MultilineConsoleMessage._WriteLines(LLt{{%66rs *X'' 4   C&&s{{F;  R5 R5la6aH^"]^"B`Ef`Er