Current File : //lib64/python2.7/site-packages/tornado/options.pyc
�
��L]c @� sy d Z d d l m Z m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l
Z
d d l Z d d l m
Z
m Z d d l m Z d d l m Z d d l m Z m Z d e f d � � YZ d
e f d � � YZ d e f d
� � YZ d e f d � � YZ e � Z e e e e e e e d � Z e e d � Z! e d � Z" e d � Z# d � Z$ e e � d S( s� A command line parsing module that lets modules define their own options.
Each module defines its own options which are added to the global
option namespace, e.g.::
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)
...
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::
tornado.options.parse_command_line()
# or
tornado.options.parse_config_file("/etc/server.conf")
Command line formats are what you would expect (``--myoption=myvalue``).
Config files are just Python files. Global names become options, e.g.::
myoption = "myvalue"
myotheroption = "myothervalue"
We support `datetimes <datetime.datetime>`, `timedeltas
<datetime.timedelta>`, ints, and floats (just pass a ``type`` kwarg to
`define`). We also accept multi-value options. See the documentation for
`define()` below.
`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()
i ( t absolute_importt divisiont print_functiont with_statementN( t _unicodet
native_str( t define_logging_options( t
stack_context( t basestring_typet exec_int Errorc B� s e Z d Z RS( s1 Exception raised by errors in the options module.( t __name__t
__module__t __doc__( ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR
W s t OptionParserc B� s� e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z
d � Z d d d d e
d d d
� Z d e d � Z e d � Z d d
� Z d � Z d � Z d � Z d � Z RS( s� A collection of options, a dictionary with object-like access.
Normally accessed via static functions in the `tornado.options` module,
which reference a global instance.
c C� s@ i | j d <g | j d <| j d d t d d d | j �d S( Nt _optionst _parse_callbackst helpt types show this help informationt callback( t __dict__t definet boolt _help_callback( t self( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt __init__b s
c C� s@ t | j j | � t � r, | j | j � St d | � � d S( Ns Unrecognized option %r( t
isinstanceR t gett _Optiont valuet AttributeError( R t name( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt __getattr__i s c C� sC t | j j | � t � r/ | j | j | � St d | � � d S( Ns Unrecognized option %r( R R R R t setR ( R R R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt __setattr__n s c C� s
t | j � S( N( t iterR ( R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt __iter__s s c C� s | j | j � S( N( R R ( R t item( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt __getitem__v s c C� s2 g | j j � D] \ } } | | j � f ^ q S( sJ A sequence of (name, value) pairs.
.. versionadded:: 3.1
( R t itemsR ( R R t opt( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR' y s c C� s t d � | j j � D� � S( sW The set of option-groups created by ``define``.
.. versionadded:: 3.1
c s� s | ] } | j Vq d S( N( t
group_name( t .0R( ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pys <genexpr>� s ( R! R t values( R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt groups� s c � s# t � f d � | j j � D� � S( s� The 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
c 3� s= | ]3 \ } } � s% � | j k r | | j � f Vq d S( N( R) R ( R* R R( ( t group( s5 /usr/lib64/python2.7/site-packages/tornado/options.pys <genexpr>� s ( t dictR R' ( R R- ( ( R- s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt
group_dict� s c C� s t d � | j j � D� � S( sL The names and values of all options.
.. versionadded:: 3.1
c s� s' | ] \ } } | | j � f Vq d S( N( R ( R* R R( ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pys <genexpr>� s ( R. R R' ( R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt as_dict� s c
C� s7 | | j k r2 t d | | j | j f � � n t j d � } | j j }
| j j j |
k r� | j j j d k r� | j } n | j j j } | |
k r� d } n | d
k r� | r� | d
k r� | j
} q� t } n | r� | } n | } t | d | d | d | d | d | d
| d | d | �| j | <d
S( s; Defines a new command line option.
If ``type`` is given (one of str, float, int, datetime, or timedelta)
or can be inferred from the ``default``, we parse the command line
arguments based on the given type. If ``multiple`` is True, we accept
comma-separated values, and the option value is always a list.
For multi-value integers, we also accept the syntax ``x:y``, which
turns into ``range(x, y)`` - very useful for long integer ranges.
``help`` and ``metavar`` are used to construct the
automatically generated command line help string. The help
message is formatted like::
--name=METAVAR help string
``group`` is used to group the defined options in logical
groups. By default, command line options are grouped by the
file in which they are defined.
Command line option names must be unique globally. They can be parsed
from the command line with `parse_command_line` or parsed from a
config file with `parse_config_file`.
If a ``callback`` is given, it will be run with the new value whenever
the option is changed. This can be used to combine command-line
and file-based options::
define("config", type=str, help="path to config file",
callback=lambda path: parse_config_file(path, final=False))
With this definition, options in the file specified by ``--config`` will
override options set earlier on the command line, but can be overridden
by later flags.
s Option %r already defined in %si R t t file_namet defaultR R t metavart multipleR) R N(
R R
R2 t syst _getframet f_codet co_filenamet f_backt co_namet Nonet __class__t strR (
R R R3 R R R4 R5 R- R t framet options_fileR2 R) ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR � s. % c
C� sL | d k r t j } n g } xt d t | � � D]� } | | j d � s[ | | } Pn | | d k r} | | d } Pn | | j d � } | j d � \ } } } | j d d � } | | j k r� | j
� t d | � � n | j | } | s$| j t
k rd } q$t d | � � n | j | � q4 W| rH| j � n | S(
s� Parses all options given on the command line (defaults to
`sys.argv`).
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.
i t -s --t =t _s$ Unrecognized command line option: %rt trues Option %r requires a valueN( R< R6 t argvt ranget lent
startswitht lstript partitiont replaceR t
print_helpR
R R t parset run_parse_callbacks(
R t argst finalt remainingt it argR t equalsR t option( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt parse_command_line� s2
c C� s� i } t | d � �# } t t | j � � | | � Wd QXx8 | D]0 } | | j k rA | j | j | | � qA qA W| r� | j � n d S( s� Parses and loads the Python config file at the given path.
If ``final`` is ``False``, parse callbacks will not be run.
This is useful for applications that wish to combine configurations
from multiple sources.
.. versionchanged:: 4.1
Config files are now always interpreted as utf-8 instead of
the system default encoding.
t rbN( t openR R t readR R! RN ( R t pathRP t configt fR ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt parse_config_file s "
c
C� s� | d k r t j } n t d t j d d | �t d d | �i } x3 | j j � D]" } | j | j g � j | � qY Wxjt
| j � � D]V\ } } | r� t d t j
j | � d | �n | j d d � � x | D]} | j } | j r
| d | j 7} n | j pd } | j d k rN| j d k rN| d
| j 7} n t j | d � } t | � d
k s�t | � d k r�| j d d � n t d | | d f d | �x, | d D] } t d d | f d | �q�Wq� Wq� Wt d | � d S( s@ Prints all the command line options to stderr (or another file).s Usage: %s [OPTIONS]i t files
Options:
s
%s options:
t keyc S� s | j S( N( R ( RU ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt <lambda>4 s RB R1 s
(default %s)iO i# i s --%-30s %si s %-34s %st Ni, ( R< R6 t stderrt printRE R R+ t
setdefaultR) t appendt sortedR' t osRZ t normpatht sortR R4 R R3 t textwrapt wrapRG t insert(
R R^ t by_groupRU t filenamet ot prefixt descriptiont linest line( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyRL ' s2 #
$ &c C� s$ | r | j � t j d � n d S( Ni ( RL R6 t exit( R R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR D s
c C� s | j j t j | � � d S( sA Adds a parse callback, to be invoked when option parsing is done.N( R Re R Rk ( R R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt add_parse_callbackI s c C� s x | j D]
} | � q
Wd S( N( R ( R R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyRN M s c C� s
t | � S( s� Returns a wrapper around self that is compatible with
`mock.patch <unittest.mock.patch>`.
The `mock.patch <unittest.mock.patch>` function (included in
the standard library `unittest.mock` package since Python 3.3,
or in the third-party ``mock`` package for older versions of
Python) is incompatible with objects like ``options`` that
override ``__getattr__`` and ``__setattr__``. This function
returns an object that can be used with `mock.patch.object
<unittest.mock.patch.object>` to modify option values::
with mock.patch.object(options.mockable(), 'name', value):
assert options.name == value
( t _Mockable( R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt mockableQ s N( R R R
R R R" R$ R& R' R, R/ R0 R< t FalseR t TrueRV R] RL R Ru RN Rw ( ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR \ s& B+ Rv c B� s2 e Z d Z d � Z d � Z d � Z d � Z RS( s `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 catpure ``__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.
c C� s | | j d <i | j d <d S( NR t
_originals( R ( R t options( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR o s
c C� s t | j | � S( N( t getattrR ( R R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR t s c C� sK | | j k s t d � � t | j | � | j | <t | j | | � d S( Ns don't reuse mockable objects( Rz t AssertionErrorR| R t setattr( R R R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR" w s c C� s# t | j | | j j | � � d S( N( R~ R Rz t pop( R R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt __delattr__| s ( R R R
R R R" R� ( ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyRv c s
R c
B� s* e Z e � Z d% e d% d% e d% d% d% d � Z d � Z d � Z d � Z
d d d d d d d
d d d
g
Z d � Z d d g f d d d g f d d d g f d d g f d d g f d d g f d d g f g Z
e d � e
D� � Z d Z e j d! e e j � Z d" � Z d# � Z d$ � Z RS(& c
C� s| | d k r | r g } n | | _ | | _ | | _ | | _ | | _ | | _ | | _ | | _ | | _ t
j | _ d S( N(
R< R R R R4 R5 R2 R) R R3 R t UNSETt _value(
R R R3 R R R4 R5 R2 R) R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR � s c C� s | j t j k r | j S| j S( N( R� R R� R3 ( R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR � s c C� s7 i | j t j 6| j t j 6| j t 6| j t 6j | j | j � } | j
r� g | _ x� | j d � D]� } t
| j t j � r� | j d � \ } } } | | � } | r� | | � n | } | j j t | | d � � qh | j j | | � � qh Wn | | � | _ | j d k r-| j | j � n | j � S( Nt ,t :i ( t _parse_datetimet datetimet _parse_timedeltat timedeltat _parse_boolR t
_parse_stringR R R R5 R� t splitt
issubclasst numberst IntegralRJ t extendRF Re R R< R ( R R t _parset partt loRC t hi( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyRM � s&
c C� s | j r� t | t � s: t d | j | j j f � � n x� | D]G } | d k rA t | | j � rA t d | j | j j f � � qA qA WnJ | d k r� t | | j � r� t d | j | j j t | � f � � n | | _ | j d k r| j | j � n d S( Ns( Option %r is required to be a list of %ss+ Option %r is required to be a %s (%s given)(
R5 R t listR
R R R R< R� R ( R R R% ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR! � s
# % s %a %b %d %H:%M:%S %Ys %Y-%m-%d %H:%M:%Ss %Y-%m-%d %H:%Ms %Y-%m-%dT%H:%Ms %Y%m%d %H:%M:%Ss %Y%m%d %H:%Ms %Y-%m-%ds %Y%m%ds %H:%M:%Ss %H:%Mc C� sS x< | j D]1 } y t j j | | � SWq
t k
r: q
Xq
Wt d | � � d S( Ns! Unrecognized date/time format: %r( t _DATETIME_FORMATSR� t strptimet
ValueErrorR
( R R t format( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR� � s
t hourst ht minutest mt mint secondst st sect millisecondst mst microsecondst ust dayst dt weekst wc c� s. | ]$ \ } } | D] } | | f Vq q d S( N( ( R* t fullt abbrevst abbrev( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pys <genexpr>� s s- [-+]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][-+]?\d+)?s \s*(%s)\s*(\w*)\s*c C� s� y� t j � } d } x� | t | � k r� | j j | | � } | sQ t � � n t | j d � � } | j d � px d } | j j | | � } | t j i | | 6� 7} | j
� } q W| SWn t k
r� � n Xd S( Ni i i R� ( R� R� RG t _TIMEDELTA_PATTERNt matcht Exceptiont floatR- t _TIMEDELTA_ABBREV_DICTR t end( R R t sumt startR� t numt units( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR� � s
c C� s | j � d k S( Nt falset 0R\ ( R� R� R\ ( t lower( R R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR� � s c C� s
t | � S( N( R ( R R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR� � s N( R R t objectR� R< R Rx R R RM R! R� R� t _TIMEDELTA_ABBREVSR. R� t _FLOAT_PATTERNt ret compilet
IGNORECASER� R� R� R� ( ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR � sB c C� s7 t j | d | d | d | d | d | d | d | �S( sO Defines an option in the global namespace.
See `OptionParser.define`.
R3 R R R4 R5 R- R ( R{ R ( R R3 R R R4 R5 R- R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR s c C� s t j | d | �S( s] Parses global options from the command line.
See `OptionParser.parse_command_line`.
RP ( R{ RV ( RO RP ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyRV s c C� s t j | d | �S( sY Parses global options from a config file.
See `OptionParser.parse_config_file`.
RP ( R{ R] ( RZ RP ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyR] s c C� s
t j | � S( si Prints all the command line options to stderr (or another file).
See `OptionParser.print_help`.
( R{ RL ( R^ ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyRL " s c C� s t j | � d S( sq Adds a parse callback, to be invoked when option parsing is done.
See `OptionParser.add_parse_callback`
N( R{ Ru ( R ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyRu * s (% R
t
__future__R R R R R� R� R� R6 Rg Rj t tornado.escapeR R t tornado.logR t tornadoR t tornado.utilR R R� R
R� R Rv R R{ R< Rx R Ry RV R] RL Ru ( ( ( s5 /usr/lib64/python2.7/site-packages/tornado/options.pyt <module>F s0 " � �
Mini Shell