@SrSSKrSSKrSr"SS\5r\"5rg)aA useful class for digesting, on a high-level, where time in a program goes. Usage: sw = StopWatch() sw.start() sw.start('foo') foo() sw.stop('foo') args = overhead_code() sw.start('bar') bar(args) sw.stop('bar') sw.dump() If you start a new timer when one is already running, then the other one will stop running, and restart when you stop this timer. This behavior is very useful for when you want to try timing for a subcall without remembering what is already running. For instance: sw.start('all_this') do_some_stuff() sw.start('just_that') small_but_expensive_function() sw.stop('just_that') cleanup_code() sw.stop('all_this') In this case, the output will be what you want: the time spent in small_but_expensive function will show up in the timer for just_that and not all_this. Nz!dbentley@google.com (Dan Bentley)cZ\rSrSrSrSrS SjrS SjrSSjrSSjr SS jr SS jr S r g) StopWatch8aClass encapsulating a timer; see above for example usage. Instance variables: timers: map of stopwatch name -> time for each currently running stopwatch, where time is seconds from the epoch of when this stopwatch was started. accum: map of stopwatch name -> accumulated time, in seconds, it has already been run for. stopped: map of timer name -> list of timer names that are blocking it. counters: map of timer name -> number of times it has been started. c<0Ul0Ul0Ul0UlgN)timersaccumstoppedcounters)selfs 4platform/bq/third_party/google/apputils/stopwatch.py__init__StopWatch.__init__EsDKDJDLDMcZU(aV/n[UR5H-nUS:XaM URU5 URU5 M/ X0RU'UR R US5S-UR U'[R"5URU'g)a[Start a timer. Args: timer: str; name of the timer to start, defaults to the overall timer. stop_others: bool; if True, stop all other running timers. If False, then you can have time that is spent inside more than one timer and there's a good chance that the overhead measured will be negative. totalrN)listrstopappendr r gettime)r timer stop_othersr others r startStopWatch.startKsg $% ))E  .. %$ll5==,,UA6:DMM%DKKrcXR;a[SU-5eURU5URU'URU URR U/5HnUR USS9 M g)zStop a running timer. This includes restarting anything that was stopped on behalf of this timer. Args: timer: str; name of the timer to stop, defaults to the overall timer. Raises: RuntimeError: if timer refers to a timer that was never started. z.Tried to stop timer that was never started: %sr)rN)r RuntimeError timervaluer r rr)r rr s r rStopWatch.stop_ss KK  :U B DD.DJJu E<<##E2. jjaj(/rNcU(d[R"5nXR;a.URRUS5X RU- -$XR;aURU$g)atReturn the value seen by this timer so far. If the timer is stopped, this will be the accumulated time it has seen. If the timer is running, this will be the time it has seen up to now. If the timer has never been started, this will be zero. Args: timer: str; the name of the timer to report on. now: long; if provided, the time to use for 'now' for running timers. )rrr r)r rnows r r StopWatch.timervaluers`  IIKc  ZZ^^E3 '3U1C+C DD **  ZZ rcURSU5nUS:Xag[URR55nX#U- - $)a Calculate the overhead. Args: now: (optional) time to use as the current time. Returns: The overhead, that is, time spent in total but not in any sub timer. This may be negative if time was counted in two sub timers. Avoid this by always using stop_others. rr#)r sumr itervalues)r r$r all_timerss r overheadStopWatch.overheadsC OOGS )E | TZZ**,-J & ''rc [R"5nURR5n/nSU;aURS5 UR 5 U(aUnUVs/sH!nXPR XRS9UR U4PM# nnU(a!URSURUS9S45 SUR;dSUR;a/URSUR SUS9UR S45 U$s snf)aHGet the results of this stopwatch. Args: verbose: bool; if True, show all times; otherwise, show only the total. Returns: A list of tuples showing the output of this stopwatch, of the form (name, value, num_starts) for each timer. Note that if the total timer is not used, non-verbose results will be the empty list. r)r$r*r) rr keysremovesortr r rr*r)r verboser$ all_namesnamesnameresultss r r4StopWatch.resultss ))+C !I E)w NNe!" 4oodo4dmmD6IJ  " nnj$--C-"8!<=$**4;; 6 nngtwC@mmG,./ N"s&(D c [R"5nURUS9n[UVs/sHn[US5PM sn5nUHnUR SXTSUS4-5 M! UR 5$s snf)zDescribes where time in this stopwatch was spent. Args: verbose: bool; if True, show all timers; otherwise, show only the total. Returns: A string describing the stopwatch. )r0rz %*s: %6.2fs r)StringIOr4maxlenwritegetvalue)r r0outputr4result maxlengths r dumpStopWatch.dumps}   Fll7l+G':'S^':;I ll?iF1I%FFG ?? ;sB)r r r r)rT)r)rNr)F) __name__ __module__ __qualname____firstlineno____doc__rrrr r*r4r?__static_attributes__rr rr8s*  %()&0($>rr)rEr7r __owner__objectrswrGrr rKs2 B  0 QQh[r