t)SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r \ Rr \ R"SSS5 \ R"SSS5 \ R"SSS 5 /rS r"S S \5r"S S\5r"SS\ R&5r"SS\ R&5r"SS\ R&5r"SS\ R&5rSrS qSrSrS!SjrSrSrS"Sjr"SS\ 5r!S r"g)#aGeneric entry point for Google applications. To use this module, simply define a 'main' function with a single 'argv' argument and add the following to the end of your source file: if __name__ == '__main__': app.run() TODO(user): Remove silly main-detection logic, and force all clients of this module to check __name__ explicitly. Fix all current clients that don't check __name__. N run_with_pdbzSet to true for PDB debug moderun_with_profilingzmSet to true for profiling the script. Execution will be slower, and the output format might change over time.use_cprofile_for_profilingTzpUse cProfile instead of the profile module for profiling. This has no effect unless --run_with_profiling is set.Fc\rSrSrSrg)Error9N)__name__ __module__ __qualname____firstlineno____static_attributes__r .platform/bq/third_party/google/apputils/app.pyrr9srrc"\rSrSrSrSSjrSrg) UsageError=aoThe arguments supplied by the user are invalid. Raise this when the arguments supplied are invalid from the point of view of the application. For example when two mutually exclusive flags have been supplied or when there are not enough non-flag arguments. It is distinct from flags.FlagsError which covers the lower level of parsing and validating individual flags. c:[RX5 X lgN)r__init__exitcode)selfmessagers rrUsageError.__init__Gs NN4!Mr)rN))r r r r __doc__rrr rrrr=s rrc$\rSrSrSrSrSrSrg)HelpFlagLz?Special boolean flag that displays usage and raises SystemExit.c H[RRUSSSSSS9 g)Nhelprzshow this help?r) short_nameallow_overrideflags BooleanFlagrrs rrHelpFlag.__init__Os* tVQ0@*-aArcRU(a [SS9 [R"S5 gg)Nr)writeto_stdoutusagesysexitrargs rParseHelpFlag.ParseSs  1 hhqk rr Nr r r r rrr2rr rrrrLsGArrc$\rSrSrSrSrSrSrg) HelpXMLFlagYz8Similar to HelpFlag, but generates output in XML format.cF[RRUSSSSS9 g)NhelpxmlFz%like --help, but generates XML outputrr$r%r(s rrHelpXMLFlag.__init__\s' tYF./1rcU(aD[RR[R5 [R "S5 gg)Nr)r&FLAGSWriteHelpInXMLFormatr.stdoutr/r0s rr2HelpXMLFlag.Parseas+  kk&&szz2 hhqk rr Nr4r rrr6r6Ys@1 rr6c$\rSrSrSrSrSrSrg) HelpshortFlaggzFSpecial bool flag that calls usage(shorthelp=1) and raises SystemExit.cF[RRUSSSSS9 g)N helpshortrzshow usage only for this modulerr:r%r(s rrHelpshortFlag.__init__js' t[!@./1rcTU(a![SSS9 [R"S5 gg)Nr) shorthelpr+r,r0s rr2HelpshortFlag.Parseos  a* hhqk rr Nr4r rrrBrBgsN1 rrBc$\rSrSrSrSrSrSrg) BuildDataFlaguz8Boolean flag that writes build data to stdout and exits.cH[RRUSSS5 g)Nshow_build_datarzshow build data and exitr%r(s rrBuildDataFlag.__init__ys  t%69;rcU(aH[RR[R 55 [R "S5 gg)Nr)r.r?write build_data BuildDatar/r0s rr2BuildDataFlag.Parse}s0  jjz++-. hhqk rr Nr4r rrrKrKus@;rrKc[U5nU$![Raan[RR SU-5 [RR S5 [R "S5 SnAgSnAff=f)zATry parsing the flags, printing usage and exiting if unparseable.zFATAL Flags parsing error: %s z1Pass --help or --helpshort to see help on flags. rN)r=r& FlagsErrorr.stderrrQr/)argsargverrors rparse_flags_with_usager[sc ;D K   JJ6>?JJIJHHQKKs BAA??Bc[(d{[R"[55 [R"[ 55 [R"[ 55 [R"[ 55 Sqgg)z Register help flags. Idempotent.TN)_define_help_flags_calledr& DEFINE_flagrr6rBrKr rrDefineHelpFlagsr_sU # " hj! km$ mo& mo& $ #rcL[5 [[R5nU$)zxRegister help flags, parse arguments and show usage if appropriate. Returns: remaining arguments after flags parsing )r_r[r.rY)rYs rRegisterAndParseFlagsWithUsageras   )$ +rc|[5nUc[RSRn[R (a+[R "[R"X55 g[R(auSSK n[R(aSSK nOSSK nUR5nURUR 5 URX5n[R "U5 g[R "U"U55 g!["an[%SXfR&S9 SnAgSnAff=f)a1Initializes flag values, and calls main with non-flag arguments. Only non-flag arguments are passed to main(). The return value of main() is used as the exit status. Args: main: Main function to run with the list of non-flag arguments, or None so that sys.modules['__main__'].main is to be used. N__main__rr)rHdetailed_errorr)rar.modulesmainr=rr/pdbruncallratexitrcProfileprofileProfileregister print_statsrr-r)rfrYrirkprofilerretvalrZs r really_startrqs ( )$ \ ;;z " ' 'DF  hhs{{4&'  ! !   + + $ ??$,,-!!$-  d F AennEFs$?D,B D6D D;D66D;c[5$)zBegin executing the program. - Parses command line flags with the flag module. - If there are any errors, print usage(). - Calls main() with the remaining arguments. - If main() raises a UsageError, print usage and the error message. ) _actual_startr rrrunrts  rcSn[S5e![a [R"5SnOf=fU(deURRRnU(dgUR R SS5nUS:waURS5(dgA[R"5 [5 g![aneSnAf[aun[HenURU5(aURU5 M-M/! [RR!["R$"55 e=f eSnAff=f)z$Another layer in the starting stack.Nr rcz .appcommands)ZeroDivisionErrorr.exc_infotb_framef_back f_globalsgetendswith exc_clearrq SystemExit ExceptionEXCEPTION_HANDLERSWantsHandlerWrQ traceback format_exc)tbprev_prev_frameprev_prev_nameehandlers rrsrss " B    B ) KK&&--/  ",,00TB. "%%n55 --/ N     & ==   ..   --/0 &   sH "448 C E C E E %'D E 5EE  EcU(a[RnO[Rn[RSRnU(d-S[R S-n[ R"USSS9nOvURS5SURS 5-- nU[R S4U--n[(a*[ R"[ R"U55nU(a[R5nO[![5nUR#U5 U(a"UR#S 5 UR#U5 UR#S 5 UbUR#S U-5 Ub[R*"U5 g g ![[[4a Nf=f![$a)nUR&[&R(:waeS nANdS nAff=f)aZWrite __main__'s docstring to stderr with some help text. Args: shorthelp: print only flags from this module, rather than all flags. writeto_stdout: write help message to stdout, rather than to stderr. detailed_error: additional detail about why usage info was presented. exitcode: if set, exit with this status code after writing help. rcz USAGE: %s [flags] rz rv)indentfirstline_indent%rwz%%z flags:  Nz %s )r.r?rWrerrYr&TextWrapcount OverflowError TypeError ValueErrorhelp_text_wrap DocToHelpr=MainModuleHelpstrrQIOErrorerrnoEPIPEr/) rHr+rdrstdfiledocnum_specifiersflag_strrs rr-r-syjjGjjG J''# !CHHQK /C ..Y DCYYs^a#))D/&99N  chhqk^n ,,c~ NN5??3/ 0c##%H5zH   MM# mmL! mmH MM$! mmH~-. HHX- 9j 1   "   ww%++  s+!FA"F4F10F14 G'>G""G'c$\rSrSrSrSrSrSrg)ExceptionHandleri8z4Base exception handler from which other may inherit.cg)zCheck if this exception handler want to handle this exception. Args: unused_exc: Exception, the current exception Returns: boolean This base handler wants to handle all exceptions, override this method if you want to be more selective. Tr )r unused_excs rrExceptionHandler.Wants;s rc[5e)zyDo something with the current exception. Args: exc: Exception, the current exception This method must be overridden. )NotImplementedError)rexcs rrExceptionHandler.HandleIs   rr N)r r r r rrrrr rrrr8s<  rrc[U[5(d[S[U5-5e[R U5 g)aQInstall an exception handler. Args: handler: an object conforming to the interface defined in ExceptionHandler Raises: TypeError: handler was not of the correct type All installed exception handlers will be called if main() exits via an abnormal exception, i.e. not one of SystemExit, KeyboardInterrupt, FlagsError or UsageError. z9handler of type %s does not inherit from ExceptionHandlerN) isinstancerrtyperappend)rs rInstallExceptionHandlerrTs< G- . . O7m$ %%G$rr)rrNN)#rrosrgsocketstatstructr.timergflagsr&r=DEFINE_booleanrrrrrr'rr6rBrKr[r]r_rarqrtrsr-objectrrr rrrs%   ^Q(HI)1)*1445I   u   %##  E%%  E%% " % "FJ) X.b v 8%r