TSrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSK J r SSK J r SS KJr SS KJr SS KJr SS KJr SSKrSS KJr SrSrSrSrSrS"SjrSr"SS\5r"SS\5r "SS\5r!"SS\5r"Sr#Sr$Sr%Sr&"S S!\'5r(g)#zDebug apis layer.)absolute_import)division)unicode_literalsN) exceptions)errors)apis)config)log) resources)retry)urllibdefaultc/nSnSnSnSnUHnU(aUR5(aUS- nSnUS:XaU(aX6- nOSnUS- nMAU(d/US:Xa[R"S5eUS :XaUS - nMqX&- nMwUS:waX6- nMUS-nUS:XaKX1;aURU5nO[ U5nUR U5 US R U5- nS nMX6- nM U(a[R"S 5eX!4$)apExtracts {expression} substrings into a separate array. Each substring of the form {expression} will be extracted into an array, and each {expression} substring will be replaced with $N, where N is the index of the extraced expression in the array. Any '$' sequence outside an expression will be escaped with '$$'. For example, given the input: 'a={a}, b={b}' The return value would be: ('a=$0, b=$1', ['a', 'b']) Args: format_string: The string to process. Returns: string, [string] - The new format string and the array of expressions. Raises: InvalidLogFormatException: if the string has unbalanced braces. rF {}z:There are too many "}" characters in the log format string$$$z${0}Tz:There are too many "{" characters in the log format string)isdigitrInvalidLogFormatExceptionindexlenappendformat) format_string expressions log_formatcurrent_expression brace_countneed_separatorcis )lib/googlecloudsdk/api_lib/debug/debug.pySplitLogExpressionsr&/sI(+*+. a!))++CjNCx  Qk  c.. HJ J 8d    cQk    , 23!+!   / 0fmmA&&  W Z  * *D FF   cj^^U4SjmURS5nSRU4SjU55$)aDReplaces each $N substring with the corresponding {expression}. This function is intended for reconstructing an input expression string that has been split using SplitLogExpressions. It is not intended for substituting the expression results at log time. Args: log_format: A string containing 0 or more $N substrings, where N is any valid index into the expressions array. Each such substring will be replaced by '{expression}', where "expression" is expressions[N]. expressions: The expressions to substitute into the format string. Returns: The combined string. c>SRT[URS5SS55$![a URS5s$f=f)Nz{{{0}}}rr)rintgroup IndexError)mrs r% GetExpression*MergeLogExpressions..GetExpressionsN   k#aggajn*=> ??  WWQZs.2AArrc3T># UHn[R"STU5v M g7f)z\$\d+N)resub).0partr.s r% &MergeLogExpressions..s!JED"&&=$77Es%()splitjoin)rrpartsr.s ` @r%MergeLogExpressionsr:|s/   4 % JEJ JJr'cSnSUR4SUR4SUR4/nU[RR U5-$)aAReturns a URL to view a breakpoint in the browser. Given a breakpoint, this transform will return a URL which will open the snapshot's location in a debug view pointing at the snapshot. Args: breakpoint: A breakpoint object with added information on project and debug target. Returns: The URL for the breakpoint. z2https://console.cloud.google.com/debug/fromgcloud?projectdbgeebp)r< target_ididr parse urlencode breakpointdebug_view_urldatas r% DebugViewUrlrGsUH.*$$% $$% Z]] $ &,,006 66r'c SRURURUR=(d SUS9nUR(a?USR[ R "SS[UR5S5US9- nU$) a|Returns an advanced log query string for use with gcloud logging read. Args: breakpoint: A breakpoint object with added information on project, service, and debug target. separator: A string to append between conditions Returns: A log query suitable for use with gcloud logging read. Raises: InvalidLogFormatException if the breakpoint has an invalid log expression. zresource.type=gae_app{sep}logName:request_log{sep}resource.labels.module_id="{service}"{sep}resource.labels.version_id="{version}"{sep}severity={logLevel}INFO)serviceversionlogLevelsepz {sep}"{text}"z \$([0-9]+)z" "r)textrM)rrJrKrLlogMessageFormatr1r2r&)rD separatorquerys r%LogQueryV2StringrRs$V$$j.@.@&&0&i$A    _ # # VVM6' (C(CDQGI $E ,r'cSnSUR4S[USS9S-4/nU[RR U5-$)adReturns a URL to view the output for a logpoint. Given a breakpoint in an appengine service, this transform will return a URL which will open the log viewer to the request log for the service. Args: breakpoint: A breakpoint object with added information on project, service, debug target, and logQuery. Returns: The URL for the appropriate logs. z&https://console.cloud.google.com/logs?r<advancedFilter )rP)r<rRr rArBrCs r% LogViewUrlrVsO<.*$$%)*ELM $ &,,006 66r'c\rSrSrSr\R "5rSrSr Sr SR\ R5rS SjrS rg) DebugObjectz"Base class for debug api wrappers.SNAPSHOTLOGPOINTcXR:Xa*URRRR$XR :Xa*URRRR $[R"U5eN) SNAPSHOT_TYPE_debug_messages BreakpointActionValueValuesEnumCAPTURE LOGPOINT_TYPELOGrInvalidBreakpointTypeError)self type_names r%BreakpointActionDebugObject.BreakpointActionsg&&&  ! ! , , B B J JJ&&&  ! ! , , B B F FF  + +I 66r'zgoogle.com/gcloud/{0}NcU=(d [R"SS5UlU=(d [R"SS5UlU=(d [R"SS5UlU=(d [R"SS5Ul[RR5Ul URRSS5 g)z+Sets up class with instantiated api client. clouddebuggerv2cloudresourcemanagerv1beta1N) rGetClientInstance _debug_clientGetMessagesModuler__resource_client_resource_messagesr REGISTRYClone_resource_parserRegisterApiByName)rf debug_clientdebug_messagesresource_clientresource_messagess r%__init__DebugObject.__init__s E..E  G$00$G   B 5yA   B 5yA &..446D++OTBr')rpr_rrrsrvNNNN)__name__ __module__ __qualname____firstlineno____doc__ threadingLock _client_lockr^rcrhrr CLOUD_SDK_VERSIONCLIENT_VERSIONr|__static_attributes__r'r%rXrXsH* !,--7+11&2J2JK.7;7;Cr'rXc^^\rSrSrSrS U4SjjrS SjrSrS SjrSr S Sjr S r U=r $) Debuggeriz/Abstracts Cloud Debugger service for a project.c6>[[U] X#XES9 XlgN)rxryrzr{)superrr|_project)rfr<rxryrzr{ __class__s r%r|Debugger.__init__s% (D"!'#NMr'cURRURUURS9nURR R U5nURVs/sHn[U5PM nnU(d [U5$U$![Ran[R"U5eSnAff=fs snf)aLists all debug targets registered with the debug service. Args: include_inactive: If true, also include debuggees that are not currently running. include_stale: If false, filter out any debuggees that refer to stale minor versions. A debugge represents a stale minor version if it meets the following criteria: 1. It has a minorversion label. 2. All other debuggees with the same name (i.e., all debuggees with the same module and version, in the case of app engine) have a minorversion label. 3. The minorversion value for the debuggee is less than the minorversion value for at least one other debuggee with the same name. Returns: [Debuggee] A list of debuggees. )r<includeInactive clientVersionN)r_)ClouddebuggerDebuggerDebuggeesListRequestrrrpdebugger_debuggeesListapitools_exceptions HttpErrorrUnknownHttpError debuggeesDebuggee_FilterStaleMinorVersions)rfinclude_inactive include_stalerequestresponseerrordebuggeeresults r% ListDebuggeesDebugger.ListDebuggees s&""LL /?))M+G+##66;;GDh2:1C1C D1CXhx 1CF D  &v .. M  ( (+  # #E **+Es%B$CB>#B99B>cUR5n[U5S:XaUS$U(d[R"5e[R"SU5e)aMFind the default debuggee. Returns: The default debug target, which is either the only target available or the latest minor version of the application, if all targets have the same module and version. Raises: errors.NoDebuggeeError if no debuggee was found. errors.MultipleDebuggeesError if there is not a unique default. rrN)rrrNoDebuggeeErrorMultipleDebuggeesError)rfrs r%DefaultDebuggeeDebugger.DefaultDebuggee.sO""$I 9~ q\   " " $$  ' 'i 88r'c^U(dJUR5n[RRSR UR 55 U$UR 5nURX15$![Ra Of=fUR SSS9nURX15$)aFind the unique debuggee matching the given pattern. Args: pattern: A string containing a debuggee ID or a regular expression that matches a single debuggee's name or description. If it matches any debuggee name, the description will not be inspected. Returns: The matching Debuggee. Raises: errors.MultipleDebuggeesError if the pattern matches multiple debuggees. errors.NoDebuggeeError if the pattern matches no debuggees. z6Debug target not specified. Using default target: {0} T)rr) rr statuswriternamer_FilterDebuggeeListrr)rfpatternr all_debuggeess r% FindDebuggeeDebugger.FindDebuggeeDs %%'h jj C J Jmm o ((*m  % %m ==  ! !   &&59';M  # #M ;;s A44B  B cU(d[R"5e[U5nUVs/sHoDRU:XdMUPM snUVs/sHoBUR:XdMUPM sn-nU(d[ R "U5nUVs/sH&oFRUR5(dM$UPM( snUVs/sH:nUR(dMURUR5(dM8UPM< sn-nU(d[R"X!S9e[SU55n[U5S:a[R"X%5eUS$s snfs snfs snfs snf)aFinds the debuggee which matches the given pattern. Args: all_debuggees: A list of debuggees to search. pattern: A string containing a debuggee ID or a regular expression that matches a single debuggee's name or description. If it matches any debuggee name, the description will not be inspected. Returns: The matching Debuggee. Raises: errors.MultipleDebuggeesError if the pattern matches multiple debuggees. errors.NoDebuggeeError if the pattern matches no debuggees. )rc38# UHoRv M g7fr])r?)r3ds r%r5/Debugger._FilterDebuggeeList..s6Iq{{Isrr) rrrr?rr1compilesearch descriptionsetrr)rfrrlatest_debuggeesrrmatch_re debuggee_idss r%rDebugger._FilterDebuggeeListds@   " " $$0?+E]kkW.D!]E-C-AFF1B!-CDI G$h& B&//!&&*A1& B& @&mm ( > & @ @   " "7 DD6I66L <1  ) )' == Q<'FC C @s5E"E"E'&E'#E,9E,E1E1E1c zU(d URnURRURRURUX#S9S9nUR R RU5n[UR5$![Ran[R"U5eSnAff=f)aRegister a debuggee with the Cloud Debugger. This method is primarily intended to simplify testing, since it registering a debuggee is only a small part of the functionality of a debug agent, and the rest of the API is not supported here. Args: description: A concise description of the debuggee. uniquifier: A string uniquely identifying the debug target. Note that the uniquifier distinguishes between different deployments of a service, not between different replicas of a single deployment. I.e., all replicas of a single deployment should report the same uniquifier. agent_version: A string describing the program registering the debuggee. Defaults to "google.com/gcloud/NNN" where NNN is the gcloud version. Returns: The registered Debuggee. )r<r uniquifier agentVersion)rN) rr_RegisterDebuggeeRequestrrrpcontroller_debuggeesRegisterrrrrr)rfrr agent_versionrrrs r%RegisterDebuggeeDebugger.RegisterDebuggees" ))m""::%%..MM{!/?;@G+##88AA'Jh H%% &&  ( (+  # #E **+s%B B:B55B:)rr~)FFr]) rrrrrr|rrrrrr __classcell__rs@r%rrs27@D7; D9,<@(T''r'rc^\rSrSrSrSU4SjjrSrSrSr\ S5r \ S5r \ S 5r \ S 5r S rS rS rSSjrSSjrSSjrSrSSjrSSjrSSjrSrSrSrSrU=r$)rizRepresents a single debuggee.c0>[[U] X#XES9 URUlURUlUR UlURUlURUl URUl URUlURUlUR"UlUR$Ul0UlUR((aAUR(R*H&nUR,UR(UR.'M( ggr)rrr|r<rrrextSourceContextsext_source_contextsr@r? isDisabled is_disabled isInactive is_inactivesourceContextssource_contextsrrtarget_uniquifierlabelsadditionalPropertiesvaluekey)rfmessagerxryrzr{lrs r%r|Debuggee.__init__s (D"!'#N??DL --D**D&88DZZDN))D))D"11D..DK$//DDK~~~~22!WW AEE3r'cl[XR5=(a URUR:H$r]) isinstancerr?rfothers r%__eq__Debuggee.__eq__s( unn - . NNeoo -/r'c.URU5(+$r])rrs r%__ne__Debuggee.__ne__s{{5! !!r'cSRURURUR(aSRUR55$S5$)Nzz, description={0}r)rr?rrrfs r%__repr__Debuggee.__repr__sN " ) )    $7#=#=d>N>N#O %%!# %%r'c:URRSS5$)Nmodulergetrs r%rJDebuggee.services ;;??8T **r'c:URRSS5$)NrKrrs r%rKDebuggee.versions ;;??9d ++r'c:URRSS5$)N minorversionrrs r%rDebuggee.minorversions ;;??>4 00r'cURnURnU(dU(a"U=(d [S-U=(d [-$UR$)N-)rJrKDEFAULT_MODULEDEFAULT_VERSIONr)rfrJrKs r%r Debuggee.names?llGllG''3 .'2L_ MM   r'c4U(dgXR:Xagg)NrDsnapshotlogpoint)r^)rfrestrict_to_types r%_BreakpointDescriptionDebuggee._BreakpointDescriptions   // /  r'cDURRXRURS9nURR R U5nURUR5$![Ran[R"U5eSnAff=f)zGets the details for a breakpoint. Args: breakpoint_id: A breakpoint ID. Returns: The full Breakpoint message for the ID.  breakpointId debuggeeIdrN) r_3ClouddebuggerDebuggerDebuggeesBreakpointsGetRequestr?rrpdebugger_debuggees_breakpointsGetrrrr AddTargetInforD)rf breakpoint_idrrrs r% GetBreakpointDebuggee.GetBreakpoints##BB -..!%!4!4C6 +##BBFFwOh   h11 22  ( (+  # #E **+s%A00BBBcURRXRURS9nURR R U5 g![Ran[R"U5eSnAff=f)z?Deletes a breakpoint. Args: breakpoint_id: A breakpoint ID. rN) r_6ClouddebuggerDebuggerDebuggeesBreakpointsDeleteRequestr?rrprDeleterrrr)rfr rrs r%DeleteBreakpointDebuggee.DeleteBreakpointsy ##EE -..!%!4!4F6 + 77>>wG  ( (+  # #E **+s%AB*BBc ^U=(d /nU=(d /n[UVs/sH8nTRRUSTR0SS9R 5PM: sn5n/n UH/nU R [ R"SU-S-55 M1 TRRTRUU=(d [U5TRS9n TR R"R%U 5n U (d#U(dTR-U R.U5$U(a0U R.Vs/sHn[1XU 5(dMUPM nnOBU R.Vs/sH+n[1XUR2(a/OU 5(dM)UPM- nnU[UVs/sHoR4PM sn5- nU(a&[R6"UTR9U55eU H`nUVs/sHn[1U/U/5(dMUPM sn(aM2[R:"TR9U5UR<5e TR-X5nU(a@U4S jnUVs/sH-nU"U5(aTR?UR45OUPM/ nnU$s snf![ Ra*n [R"SRXz55eSn A ff=f![&R(an [R*"U 5eSn A ff=fs snfs snfs snfs snfs snf) aYReturns all breakpoints matching the given IDs or patterns. Lists all breakpoints for this debuggee, and returns every breakpoint where the location field contains the given pattern or the ID is exactly equal to the pattern (there can be at most one breakpoint matching by ID). Args: location_regexp: A list of regular expressions to compare against the location ('path:line') of the breakpoints. If both location_regexp and resource_ids are empty or None, all breakpoints will be returned. resource_ids: Zero or more resource IDs in the form expected by the resource parser. These breakpoints will be retrieved regardless of the include_all_users or include_inactive flags include_all_users: If true, search breakpoints created by all users. include_inactive: If true, search breakpoints that are in the final state. This option controls whether regular expressions can match inactive breakpoints. If an object is specified by ID, it will be returned whether or not this flag is set. restrict_to_type: An optional breakpoint type (LOGPOINT_TYPE or SNAPSHOT_TYPE) full_details: If true, issue a GetBreakpoint request for every result to get full details including the call stack and variable table. Returns: A list of all matching breakpoints. Raises: InvalidLocationException if a regular expression is not valid. rz,clouddebugger.debugger.debuggees.breakpoints)params collectionz^(.*/)?(z)$zHThe location pattern "{0}" is not a valid Python regular expression: {1}N)rincludeAllUsersrrc>UR(+=(d( URTRTR5:H=(aA UR=(a. UR=(a URR (+$r])actionrhr^ isFinalStaterisError)r>rfs r%IsCompletedSnapshot5Debuggee.ListBreakpoints..IsCompletedSnapshotfsaYYHd33D4F4FGGJJ)+)Hryy7H7H$I Kr') rrvParser?Namerr1rrrInvalidLocationExceptionrr_4ClouddebuggerDebuggerDebuggeesBreakpointsListRequestboolrrprrrrr_FilteredDictListWithInfo breakpoints_BreakpointMatchesIdOrRegexprr@BreakpointNotFoundErrorr NoMatchErrorrr )rflocation_regexp resource_idsinclude_all_usersrr full_detailsridspatternserrrr>r missing_idsprs` r%ListBreakpointsDebuggee.ListBreakpoints s4< %2L%+O  Q    $ $ |T^^4E % GGKtv N  !C H , ;?T#9:;##CC"nn#4#3#@tCy!%!4!4 D6 +##BBGGPh C  + +H,@,@,<>>&11D1r/B1fDf&11C1r/2??RB1fCV4VrUUV455K  * * t223CD FF!<6R-b"qc:6<<!!$"="=>N"O"#))- -  + +F EFK b(;2'>'>$  RUU #B F  MC XX,-- $fQl, ,,  ( (+  # #E **+DC5<se?J>/+K!%LL6L65(L;!L;3M M"M4M L%K<<LL3L..L3c  SnU(awURRR[R"U5VVs/sH2upxURRRR XxS9PM4 snnS9nUR U5nU(d/nURRURURRXUXdURRRRS9URS9n URRRU 5n UR'U R(5$s snnf![R an ["R$"U 5eSn A ff=f)aCreates a "snapshot" breakpoint. Args: location: The breakpoint source location, which will be interpreted by the debug agents on the machines running the Debuggee. Usually of the form file:line-number condition: An optional conditional expression in the target's programming language. The snapshot will be taken when the expression is true. expressions: A list of expressions to evaluate when the snapshot is taken. user_email: The email of the user who created the snapshot. labels: A dictionary containing key-value pairs which will be stored with the snapshot definition and reported when the snapshot is queried. Returns: The created Breakpoint message. Nrrr)location conditionrr userEmailrrrDr)r_r` LabelsValuesix iteritemsAdditionalProperty_LocationFromString3ClouddebuggerDebuggerDebuggeesBreakpointsSetRequestr?rarbrrprSetrrrrrrD) rfr4r5r user_emailr labels_valuerrrrrs r%CreateSnapshotDebuggee.CreateSnapshotpsj$L ))44@@!$ f 5 7!6*#""--99LLM( 5 7A8l ''1H k ;;~~++66!K#,,77--gg 78 -- < / +##BBFFwOh   h11 22+ 7&  ( (+  # #E **+s9E %EF'E==FcU(d[R"S5eU(d[R"S5eSnU(awURRR [ R"U5VV s/sH2upURRR RXS9PM4 sn nS9nURU5nU(a3URRRUR55n[U5upURRURURR XUXXuURRRR S9UR"S9n UR$R&R)U 5n UR1U R25$s sn nf![*R,an[R."U5eSnAff=f)aCreates a logpoint in the debuggee. Args: location: The breakpoint source location, which will be interpreted by the debug agents on the machines running the Debuggee. Usually of the form file:line-number log_format_string: The message to log, optionally containin {expression}- style formatting. log_level: String (case-insensitive), one of 'info', 'warning', or 'error', indicating the log level that should be used for logging. condition: An optional conditional expression in the target's programming language. The snapshot will be taken when the expression is true. user_email: The email of the user who created the snapshot. labels: A dictionary containing key-value pairs which will be stored with the snapshot definition and reported when the snapshot is queried. Returns: The created Breakpoint message. Raises: InvalidLocationException: if location is empty or malformed. InvalidLogFormatException: if log_format is empty or malformed. zThe location must not be empty.z(The log format string must not be empty.Nr2r3)r4r5rLrOrrr6rr7)rrrr_r`r8r9r:r;r<LogLevelValueValuesEnumupperr&r=r?rardrrprr>rrrrrD)rfr4log_format_string log_levelr5r?rr@rrlog_message_formatrrrrs r%CreateLogpointDebuggee.CreateLogpoints.   + + + --   , , 4 66L ))44@@!$ f 5 7!6*#""--99LLM( 5 7A8l ''1H    ) ) A Aoo !'::K&L# ;;~~++66!!3#,,77--cc 74 -- < / +##BBFFwOh   h11 223 7.  ( (+  # #E **+s<9G %G G; G66G;cUR URRRU5sSSS5 $!,(df  g=fr])rrprr)rfrs r%_CallGetDebuggee._CallGets1      > > B B7 K   s %< A c^U4SjnURXUUS9$![Ran[R"U5eSnAff=f)aWaits for a breakpoint to be set by at least one agent. Breakpoint set can be detected in two ways: it can be completed, or the location may change if the breakpoint could not be set at the specified location. A breakpoint may also be set without any change being reported to the server, in which case this function will wait until the timeout is reached. Args: breakpoint_id: A breakpoint ID. original_location: string, the user-specified breakpoint location. If a response has a different location, the function will return immediately. timeout: The number of seconds to wait for completion. retry_ms: Milliseconds to wait betweeen retries. Returns: The Breakpoint message, or None if the breakpoint did not get set before the timeout. c>URR=(d+ T=(a" T[URR5:g$r])rDr_FormatLocationr4)r)original_locations r% MovedOrFinal3Debuggee.WaitForBreakpointSet..MovedOrFinals< ,, # # H  G  0E0E F FIr')r timeoutretry_mscompletion_testN)WaitForBreakpointrrrr)rfr rQrTrUrRrs ` r%WaitForBreakpointSetDebuggee.WaitForBreakpointSetsW&I +  # #%&$((  ( (+  # #E **+sA AA c^T(dSmU4Sjn[R"UbSU-OSSS9nURRXRUR S9nUR URU/UUS9nT"U5(dgURUR5$![Ra g[Ran [R"U 5eSn A ff=f)aWaits for a breakpoint to be completed. Args: breakpoint_id: A breakpoint ID. timeout: The number of seconds to wait for completion. retry_ms: Milliseconds to wait betweeen retries. completion_test: A function that accepts a Breakpoint message and returns True if the breakpoint wait is not finished. If not specified, defaults to a function which just checks the isFinalState flag. Returns: The Breakpoint message, or None if the breakpoint did not complete before the timeout, c.URR$r])rDr)r)s r%,Debuggee.WaitForBreakpoint.. s!,,";";r'c>T"U5(+$r]r)r)_rVs r%r\r] s  22r'Ni) max_wait_mswait_ceiling_msr)should_retry_ifsleep_ms)r Retryerr_rr?r RetryOnResultrLRetryExceptionrrrrrrD) rfr rTrUrVretry_ifretryerrrrs ` r%rWDebuggee.WaitForBreakpoints ;o2Hmm$+$7DLTG##BB -..!%!4!4C6 +$$T]]WI5=.6%8f 6 " "    f// 00      ( (+  # #E **+sB$$C(:C( C##C(c[X#5nUHnURX5 M UR5nUVs/sHoUU;dM XePM sn$s snf)aWaits for one or more breakpoints to complete. Args: ids: A list of breakpoint IDs. wait_all: If True, wait for all breakpoints to complete. Otherwise, wait for any breakpoint to complete. timeout: The number of seconds to wait for completion. Returns: The completed Breakpoint messages, in the order requested. If wait_all was specified and the timeout was reached, the result will still comprise the completed Breakpoints. )_BreakpointWaiter AddTargetWait)rfr*wait_allrTwaiterr$resultss r%WaitForMultipleBreakpoints#Debuggee.WaitForMultipleBreakpoints!sQx 1F  tkkmG # 41G|JGJ 44 4s AAc [UURURURURUR S.S9nUR URRRR:Xa>UR(d-URRRRUS'URcSUS'UR(a[!UR5US'UR"(a4[%UR"UR&5US'UR)S5 UR*(aUR*R,(dfUR UR/UR05:Xa/UR2(a[5U5US '[7U5US 'U$[9U5US 'U$) aConverts a message into an object with added debuggee information. Args: message: A message returned from a debug API call. Returns: An object including the fields of the original object plus the following fields: project, target_uniquifier, and target_id. )r<rr?rJrK) hidden_fieldsrLFrr4rOrlogQuery logViewUrlconsoleViewUrl) _MessageDictr<rr?rJrKrr_r`rardrLrDrIrr4rPrOr:rHideExistingFieldrrrhrcrrRrVrG)rfrrs r%rDebuggee.AddTargetInfo4sz'<<!33^^<<<< 2!"F  ''==AA B       ) ) A A F F Z#$f^*7+;+;7J7J$Lf   }- >>!7!7 4001C1CD D   /7& !+F!3&  M$0#7 Mr'c URS5n[U5S:wa[R"S5eURR US[ US5S9$![a [R"S5ef=f)zConverts a file:line location string into a SourceLocation. Args: location: A string of the form file:line. Returns: The corresponding SourceLocation message. Raises: InvalidLocationException: if the line is not of the form path:line :z(Location must be of the form "path:line"rr)pathlinezJLocation must be of the form "path:line", where "line" must be an integer.)r7rrrr_SourceLocationr* ValueError)rfr4 componentss r%r<Debuggee._LocationFromStringbs$J :!  + + 4 66  ! ! 0 0jm69*Q-6H1JJ   + +  s (A!!!BcUVs/sH^nU(aCURURU5:Xd$UR(aM<X R:XdMMURU5PM` sn$s snf)a<Filters a result list to contain only breakpoints of the given type. Args: result: A list of breakpoint messages, to be filtered. restrict_to_type: An optional breakpoint type. If None, no filtering will be done. Returns: The filtered result, converted to equivalent dicts with debug info fields added. )rrhr^r)rfrrr)s r%r "Debuggee._FilteredDictListWithInfoxsm,2 J6a#xx4001ABBHH ""25G5G!G "D  q !6 JJ Js;A- A-A-) rrrrrrr<rrr?rr~)NNFFNF)N)NrN)FN)rrrrrr|rrrpropertyrJrKrrrr rr/rArIrLrXrWrqrr<r rrrs@r%rrs%@D7;%(/"%  + + , , 1 1  3$ +@D@E:?bHBF-1*3XCG=A93vLLP$'+>EH(,%1N5&,\,JJr'rc6\rSrSrSrSrSrSrSrSr Sr g ) rkiasWaits for multiple breakpoints. Attributes: _result_lock: Lock for modifications to all fields _done: Flag to indicate that the wait condition is satisfied and wait should stop even if some threads are not finished. _threads: The list of active threads _results: The set of completed breakpoints. _failures: All exceptions which caused any thread to stop waiting. _wait_all: If true, wait for all breakpoints to complete, else wait for any breakpoint to complete. Controls whether to set _done after any breakpoint completes. _timeout: Mazimum time (in ms) to wait for breakpoints to complete. c[R"5UlSUl/Ul0Ul/UlXlX lg)NF) rr _result_lock_done_threads_results _failures _wait_all_timeout)rfrnrTs r%r|_BreakpointWaiter.__init__s7!(DDJDMDMDNNMr'cURR(agUR URsSSS5 $!,(df  g=f)NT)rDrrr)rfrs r% _IsComplete_BreakpointWaiter._IsCompletes0''    ZZ   s ? A cpURX RURS9nU(d.UR UR(dSUlSSS5 gUR (a<UR X0RU'UR(dSUlSSS5 gg!,(df  g=f!,(df  g=f![RaVnUR URRU5 SUlSSS5 SnAg!,(df  SnAg=fSnAff=f)N)rTrVT) rWrrrrrrrr DebugErrorrr)rfrr rDr,s r% _WaitForOne_BreakpointWaiter._WaitForOnes-- **.,j   DJ     )3-- &DJ  !            a      sv7C B)C C 8'B:C ) B73C 7C : CC C D5 D0+#DD0 D- %D0-D00D5cvURR[R"URX4S95 g)N)targetargs)rrrThreadr)rfrr s r%rl_BreakpointWaiter.AddTargets0MM 0 0'7 9:r'cURHnUR5 M URHnUR5 M UR(aURSeUR$)Nr)rstartr8rr)rfts r%rm_BreakpointWaiter.WaitsP ]]ggi ]]ffh ~~ NN1  ==r')rrrrrrrN) rrrrrr|rrrlrmrrr'r%rkrks   *: r'rkc^U(dgSRURUR5$)Nz{0}:{1})rr~r)r4s r%rPrPs#     (-- 77r'cURU;agUR(dg[UR5nUHnURU5(dM g g)aoCheck if a breakpoint matches any of the given IDs or regexps. Args: breakpoint: Any _debug_messages.Breakpoint message object. ids: A set of strings to search for exact matches on breakpoint ID. patterns: A list of regular expressions to match against the file:line location of the breakpoint. Returns: True if the breakpoint matches any ID or pattern. TF)r@r4rPmatch)rDr*r+r4r.s r%r"r"sP]]c      Z00 1( awwx   r'c60nUHAnURU;aXRRU5 M2U/XR'MC /nUR5H9n[U5nU(aURU5 M(UR U5 M; U$)amFilter out any debugees referring to a stale minor version. Args: debuggees: A list of Debuggee objects. Returns: A filtered list containing only the debuggees denoting the most recent minor version with the given name. If any debuggee with a given name does not have a 'minorversion' label, the resulting list will contain all debuggees with that name. )rrvalues_FindLatestMinorVersionextend)rbynamerr name_listlatests r%rrs &h}} ]]""8,'jf]]  &==?i $Y /F  mmF mmI # -r'c&U(dgSnSnSnUHknU(d URnOX4R:wa gURRSS5nU(d g[U5nU(aXR:aUnUnMkMm U$![a  gf=f)aqGiven a list of debuggees, find the one with the highest minor version. Args: debuggees: A list of Debuggee objects. Returns: If all debuggees have the same name, return the one with the highest integer value in its 'minorversion' label. If any member of the list does not have a minor version, or if elements of the list have different names, returns None. Nrr)rrrr*r)rbest best_versionrr minor_versions r%rrs   $, $ a  VVd  HHLL3M  -(m ]9$ :  +  sB BBc<^\rSrSrSrSU4SjjrSrSrSrU=r $)rxi*zqAn extensible wrapper around message data. Fields can be added as dictionary items and retrieved as attributes. c>>[[U] 5 [U5RUlU(aX lO0UlUR5HGn[XR5nU(dX@R UR'M9X@UR'MI gr]) rrxr|typer _orig_type_hidden_fields all_fieldsgetattrr)rfrrtfieldrrs r%r|_MessageDict.__init__0st ,&(7m,,DO)d##%gzz*e */EJJ' UZZ &r'cX;aX$XR;aURU$[SRURU55e)Nz(Type "{0}" does not have attribute "{1}")rAttributeErrorrr)rfattrs r% __getattr___MessageDict.__getattr__>sP | Z """   && CJJ   r'cbXR;agURUS5URU'gr])rpop)rf field_names r%ry_MessageDict.HideExistingFieldFs,((( &*hhz4&@D #r')rrr]) rrrrrr|rryrrrs@r%rxrx*s ! AAr'rx)r))r __future__rrrr1rapitools.base.pyrrgooglecloudsdk.api_lib.debugrgooglecloudsdk.api_lib.utilrgooglecloudsdk.corer r r googlecloudsdk.core.utilr r9 six.movesr rrr&r:rGrRrVobjectrXrrrkrPr"rrdictrxrr'r%rs &' >/,&#)* J!ZK27*<7(#C&#CLg'{g'TZJ{ZJzAAH8 ,< FA4Ar'