hgSrSSKrSSKrSSKrSSKrSSKrSSKrSSKJrJ r SSK J r SSK J r Jr SSKJrJrJrJrJrJrJrJrJrJr "SS\5r"S S 5r"S S 5r"S S5r\"5rS!S\ S\S\\!S\\ S\\ S\"S\\ S\\\/S4SS4Sjjr#S"S\\\ S\"S\\ 4Sjjr$S#S\ S\"SS4Sjjr%S$S\\SS4Sjjr&S\/S4SS4S jr'\ "\5 g)%a A command line parsing module that lets modules define their own options. This module is inspired by Google's `gflags `_. The primary difference with libraries such as `argparse` is that a global registry is used so that options may be defined in any module (it also enables `tornado.log` by default). The rest of Tornado does not depend on this module, so feel free to use `argparse` or other configuration libraries if you prefer them. Options must be defined with `tornado.options.define` before use, generally at the top level of a module. The options are then accessible as attributes of `tornado.options.options`:: # myapp/db.py from tornado.options import define, options define("mysql_host", default="127.0.0.1:3306", help="Main user DB") define("memcache_hosts", default="127.0.0.1:11011", multiple=True, help="Main user memcache servers") def connect(): db = database.Connection(options.mysql_host) ... # myapp/server.py from tornado.options import define, options define("port", default=8080, help="port to listen on") def start_server(): app = make_app() app.listen(options.port) The ``main()`` method of your application does not need to be aware of all of the options used throughout your program; they are all automatically loaded when the modules are loaded. However, all modules that define options must have been imported before the command line is parsed. Your ``main()`` method can parse the command line or parse a config file with either `parse_command_line` or `parse_config_file`:: import myapp.db, myapp.server import tornado if __name__ == '__main__': tornado.options.parse_command_line() # or tornado.options.parse_config_file("/etc/server.conf") .. note:: When using multiple ``parse_*`` functions, pass ``final=False`` to all but the last one, or side effects may occur twice (in particular, this can result in log messages being doubled). `tornado.options.options` is a singleton instance of `OptionParser`, and the top-level functions in this module (`define`, `parse_command_line`, etc) simply call methods on it. You may create additional `OptionParser` instances to define isolated sets of options, such as for subcommands. .. note:: By default, several options are defined that will configure the standard `logging` module when `parse_command_line` or `parse_config_file` are called. If you want Tornado to leave the logging configuration alone so you can manage it yourself, either pass ``--logging=none`` on the command line or do the following to disable it in code:: from tornado.options import options, parse_command_line options.logging = None parse_command_line() .. note:: `parse_command_line` or `parse_config_file` function should called after logging configuration and user-defined command line flags using the ``callback`` option definition, or these configurations will not take effect. .. versionchanged:: 4.3 Dashes and underscores are fully interchangeable in option names; options can be defined, set, and read with any mix of the two. Dashes are typical for command-line usage while config files require underscores. N)_unicode native_str)define_logging_options)basestring_typeexec_in) AnyIteratorIterableTupleSetDictCallableListTextIOOptionalc\rSrSrSrSrg)Errorz1Exception raised by errors in the options module.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__rbC:\Users\julio\OneDrive\Documentos\Trabajo\Ideas Frescas\venv\Lib\site-packages\tornado/options.pyrrs;rrc\rSrSrSrS'SjrS\S\4SjrS\S\4Sjr S\S \SS4S jr S\ 4S jr S\S\ 4S jrS\S\4S jrS\S \SS4SjrS\\\\44SjrS\\4SjrS\S\\\44SjrS\\\44SjrS(S\S\S\\S\\S\\S\ S\\S\\\/S4SS4SjjrS)S\\\S\ S\\4SjjrS*S\S\ SS4SjjrS+S \\ SS4S!jjr!S \ SS4S"jr"S\/S4SS4S#jr#S'S$jr$S,S%jr%S&r&g)- OptionParserzA collection of options, a dictionary with object-like access. Normally accessed via static functions in the `tornado.options` module, which reference a global instance. returnNc0URS'/URS'URS[SURS9 g)N_options_parse_callbackshelpzshow this help information)typer%callback)__dict__definebool_help_callbackselfs r__init__OptionParser.__init__sB$& j!,. () -((  rnamec&URSS5$)N_-)replacer-r0s r_normalize_nameOptionParser._normalize_names||C%%rcURU5n[URRU5[5(aURUR 5$[ SU-5eNzUnrecognized option %r)r6 isinstancer#get_OptionvalueAttributeErrorr5s r __getattr__OptionParser.__getattr__sW##D) dmm''-w 7 7==&,,. .5<==rr=cURU5n[URRU5[5(aURUR U5$[ SU-5er9)r6r:r#r;r<setr>r-r0r=s r __setattr__OptionParser.__setattr__sY##D) dmm''-w 7 7==&**51 15<==rcDSURR55$)Nc38# UHoRv M g7fNr0).0opts r (OptionParser.__iter__..s;$:S$:s)r#valuesr,s r__iter__OptionParser.__iter__s;DMM$8$8$:;;rc@URU5nXR;$rH)r6r#r5s r __contains__OptionParser.__contains__s##D)}}$$rc$URU5$rH)r?r5s r __getitem__OptionParser.__getitem__s%%rc$URX5$rH)rDrCs r __setitem__OptionParser.__setitem__s,,rcURR5VVs/sH!upURUR54PM# snn$s snnf)z;An iterable of (name, value) pairs. .. versionadded:: 3.1 r#itemsr0r=r-r0rKs rr\OptionParser.itemss< :>9L9L9NO9NID399;'9NOOOs(A ctURR5Vs1sHoRiM sn$s snf)zGThe set of option-groups created by ``define``. .. versionadded:: 3.1 )r#rN group_name)r-rKs rgroupsOptionParser.groupss- +/--*>*>*@A*@3*@AAAs5groupcURR5VVs0sH8up#U(aXR:XdMURUR 5_M: snn$s snnf)aThe names and values of options in a group. Useful for copying options into Application settings:: from tornado.options import define, parse_command_line, options define('template_path', group='application') define('static_path', group='application') parse_command_line() application = Application( handlers, **options.group_dict('application')) .. versionadded:: 3.1 )r#r\r`r0r=)r-rcr0rKs r group_dictOptionParser.group_dictsU&"]]002 2 E^^3 "CHHciik !2   s A!A!cURR5VVs0sH upURUR5_M" snn$s snnf)z) file_namerjr&r%rkrlr`r') r6r#rrpsys _getframef_code co_filenamef_backco_name __class__strr<)r-r0rjr&r%rkrlrcr' normalizedframe options_filerpr`options rr)OptionParser.definesDZ))$/  &t}}Z8BBD  a    <<33L  (LL''33|CLL''//8; <<+ ++ ++77I#I  $I < 3(( J"J !  %+ j!rargsfinalcVUc[Rn/n[S[U55HnXR S5(dXSn OXS:Xa XS-Sn OXR S5nUR S5upgnURU5nX`R;aUR5 [SU-5eURUn U(d%U R[:XaSnO[SU-5eU RU5 M U(aUR5 U$) aParses all options given on the command line (defaults to `sys.argv`). Options look like ``--option=value`` and are parsed according to their ``type``. For boolean options, ``--option`` is equivalent to ``--option=true`` If the option has ``multiple=True``, comma-separated values are accepted. For multi-value integer options, the syntax ``x:y`` is also accepted and equivalent to ``range(x, y)``. Note that ``args[0]`` is ignored since it is the program name in `sys.argv`. We return a list of all arguments that are not parsed as options. If ``final`` is ``False``, parse callbacks will not be run. This is useful for applications that wish to combine configurations from multiple sources. Nr3z--=z$Unrecognized command line option: %rtruezOption %r requires a value)rqargvrangelen startswithlstrip partitionr6r# print_helprr&r*parserun_parse_callbacks) r-r~r remainingiargr0equalsr=r|s rparse_command_lineOptionParser.parse_command_line;s0 <88D q#d)$A7%%c** H w$ QM '..%C"%--"4 D%''-D==(!BTIJJ]]4(F;;$&"E )OptionParser.print_help..sfkkr)keyrroz (default %s),z --30 r34)rqstderrprintrr#rN setdefaultr`appendsortedr\rrnormpathsortr6r0rkr%rjtextwrapwraprinsert) r-rby_groupr|filenameoprefix descriptionlineslines rrOptionParser.print_helps <::D #chhqk1= n4(mm**,F    1 12 6 = =f E-"(.."23KH'"''*:*:8*DD4P FF1F 2--fkk:>>cFNN22F$kk/R >>-&..B2F?V^^#CCK k7;v;#s5zQLLB'a9E!!"IDT2>& 4$ 4rc`U(a'UR5 [R"S5 gg)Nr)rrqexitr-r=s rr+OptionParser._help_callbacks  OO  HHQK rc:URRU5 g)zAAdds a parse callback, to be invoked when option parsing is done.N)r$rr-r's radd_parse_callbackOptionParser.add_parse_callbacks $$X.rc8URH nU"5 M grH)r$rs rr OptionParser.run_parse_callbackss--H J.rc[U5$)aReturns a wrapper around self that is compatible with `unittest.mock.patch`. The `unittest.mock.patch` function is incompatible with objects like ``options`` that override ``__getattr__`` and ``__setattr__``. This function returns an object that can be used with `mock.patch.object ` to modify option values:: with mock.patch.object(options.mockable(), 'name', value): assert options.name == value ) _Mockabler,s rmockableOptionParser.mockablesrr)r!NNNNNFNNNTTrH)r!r)'rrrrrr.rxr6rr?rDr rOr*rRrUrXr r r\r rar rerhrr&rr)rrrrrr+rrrrrrrrrs6  &C&C&>>> >>C>D> <(<%%%&&&--C-D-Pxc3h0PBCB  S#X .Nc3hN#"!%#48Z+Z+Z+tn Z+ sm Z+ # Z+Z+}Z+8SE4K01Z+ Z+z?C4T#Y'47;4 c4lE'cE'$E'$E'Nx/4<DT /8BH+=/$/ rrcd\rSrSrSrS\SS4SjrS\S\4Sjr S\S \SS4S jr S\SS4S jr S r g) ria`mock.patch` compatible wrapper for `OptionParser`. As of ``mock`` version 1.0.1, when an object uses ``__getattr__`` hooks instead of ``__dict__``, ``patch.__exit__`` tries to delete the attribute it set instead of setting a new one (assuming that the object does not capture ``__setattr__``, so the patch created a new attribute in ``__dict__``). _Mockable's getattr and setattr pass through to the underlying OptionParser, and delattr undoes the effect of a previous setattr. optionsr!Nc>XRS'0URS'g)Nr# _originals)r()r-rs rr._Mockable.__init__s$+ j!&( l#rr0c.[URU5$rH)getattrr#r5s rr?_Mockable.__getattr__st}}d++rr=cXR;dS5e[URU5URU'[URX5 g)Nzdon't reuse mockable objects)rrr#setattrrCs rrD_Mockable.__setattr__s???*J,JJ* ' t < t+rcb[URXRRU55 grH)rr#rpopr5s r __delattr___Mockable.__delattr__ s t__%8%8%>?rr) rrrrrrr.rxrr?rDrrrrrrrs] ) )) ,,,,,C,D, @@@rrc\rSrSr\"5rS"S\S\S\\ S\\S\\S\ S \\S \\S \\ \/S4S S4S jjr S \4Sjr S\S \4SjrS\S S4Sjr/SQrS\S \R"4SjrSSSSSSSSSS. rSr\R,"S\-\R.5rS\S \R24SjrS\S \ 4SjrS\S \4S jrS!rg)#r<iNr0rjr&r%rkrlrpr`r'r!c Uc U(a/nXlUc [S5eX0lX@lXPlX`lXplXlXlX l [RUl g)Nztype must not be None) r0 ValueErrorr&r%rkrlrpr`r'rjr<UNSET_value) r-r0rjr&r%rkrlrpr`r's rr._Option.__init__sY ?xG <45 5    "$  mm rclUR[RLa UR$UR$rH)rr<rrjr,s rr= _Option.value0s$#{{gmm;t||LLrr=c"[RUR[RUR[UR [ UR0RURUR5nUR(a/Ul URS5Hn[UR[R5(aVUR!S5upEnU"U5nU(aU"U5OUnURR#[%XxS-55 MURR'U"U55 M O U"U5Ul UR(bUR)UR5 UR+5$)N,:r)datetime_parse_datetime timedelta_parse_timedeltar* _parse_boolr _parse_stringr;r&rlrsplit issubclassnumbersIntegralrextendrrr'r=) r-r=_parsepartlo_strr2hi_strlohis rr _Option.parse3s$   t33    5 5 $"" T//  # IItyy  ==DK C(dii)9)9::(,s(;%FvB+1rBKK&&uRa'89KK&&vd|4)!-DK == $ MM$++ &zz|rc |UR(a[U[5(d1[SUR<SUR R <35eUHSnUcM[X R 5(aM$[SUR<SUR R <35e O\UbY[XR 5(d?[SUR<SUR R <S[ U5<S35eXlURbURUR5 gg)Nrnrz is required to be a z (z given)) rlr:rrr0r&rrr')r-r=items rrB _Option.setMs ==eT**yy$))"4"46#JtYY,G,G99dii&8&8: E99)E)Eyy$))"4"4d5kC == $ MM$++ & %r) z%a %b %d %H:%M:%S %Yz%Y-%m-%d %H:%M:%Sz%Y-%m-%d %H:%Mz%Y-%m-%dT%H:%Mz%Y%m%d %H:%M:%Sz %Y%m%d %H:%Mz%Y-%m-%dz%Y%m%dz%H:%M:%Sz%H:%McURH#n[RRX5s $ [ SU-5e![a MBf=f)Nz!Unrecognized date/time format: %r)_DATETIME_FORMATSrstrptimerr)r-r=formats rr_Option._parse_datetimersU,,F ((11%@@- 7%?@@  sA AAhoursminutesseconds milliseconds microsecondsdaysweeks) hmminssecmsusdwz-[-+]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][-+]?\d+)?z\s*(%s)\s*(\w*)\s*c[R"5nSnU[U5:aURR X5nU(d [ 5e[ URS55nURS5=(d SnURRXf5nU[R"S0Xe0D6- nUR5nU[U5:aMU$![ a ef=f)Nrrrr) rrr_TIMEDELTA_PATTERNmatch Exceptionfloatrc_TIMEDELTA_ABBREV_DICTr;end)r-r=sumstartr numunitss rr_Option._parse_timedeltas $$&CE#e*$++11%?#+%AGGAJ' /i3377Ex))9UL99#e*$J   sCC C C,c(UR5S;$)N)false0r)lowerrs rr_Option._parse_bools{{}$777rc[U5$rH)rrs rr_Option._parse_strings r) rr'rjrpr`r%rkrlr0r&)NNNNFNNN)rrrrobjectrrxrrr&r*rr.r=rrBrrrr_FLOAT_PATTERNrecompile IGNORECASErrrrrrrrrr<r<s HE #"!%#'$(48$$$tn $ sm $ # $$C=$SM$8SE4K01$ $6MsM334'''0 ASAX->->A     FN. ch.@.@$88833rr<r0rjr&r%rkrlrcr'r!c 6[RUUUUUUUUS9$)zGDefines an option in the global namespace. See `OptionParser.define`. )rjr&r%rkrlrcr')rr))r0rjr&r%rkrlrcr's rr)r)s2 >>      rr~rc([RXS9$)zUParses global options from the command line. See `OptionParser.parse_command_line`. r)rr)r~rs rrrs  % %d % 88rrc([RXS9$)zQParses global options from a config file. See `OptionParser.parse_config_file`. r/)rr)rrs rrrs  $ $T $ 77rrc,[RU5$)zaPrints all the command line options to stderr (or another file). See `OptionParser.print_help`. )rrrs rrrs   d ##rc.[RU5 g)ziAdds a parse callback, to be invoked when option parsing is done. See `OptionParser.add_parse_callback` N)rr)r's rrrs  x(rrrrrH)(rrrr*rqrrtornado.escaperr tornado.logr tornado.utilrrtypingrr r r r r rrrrrrrrr<rrxr&r*r)rrrrrrrr7s Tl /.1    I iiX @@