File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/ext/tornado/__pycache__/options.cpython-310.pyc
Back
o ;j�S � @ s d Z ddlmZmZmZ ddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z ddlmZ ddlmZ ddlmZmZ G dd � d e�ZG d d � d e�ZG d d � d e�ZG dd� de�Ze� Z d dd�Z d dd�Z d dd�Z d dd�Z dd� Z ee� dS ) aT 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 salt.ext.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") .. note: When using tornado.options.parse_command_line or tornado.options.parse_config_file, the only options that are set are ones that were previously defined with tornado.options.define. 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 salt.ext.tornado.options import options, parse_command_line options.logging = None parse_command_line() .. 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. � )�absolute_import�division�print_functionN)�_unicode� native_str)�define_logging_options)� stack_context)�basestring_type�exec_inc @ s e Zd ZdZdS )�Errorz1Exception raised by errors in the options module.N)�__name__� __module__� __qualname__�__doc__� r r �L/opt/saltstack/salt/lib/python3.10/site-packages/salt/ext/tornado/options.pyr e s r c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Z d-d d �Zd.d d �Zd/d!d"�Zd0d#d$�Zd%d&� Zd'd(� Zd)d*� Zd+d,� ZdS )1� OptionParserz�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< | jdtd| jd� d S )N�_options�_parse_callbacks�helpzshow this help information)�typer �callback)�__dict__�define�bool�_help_callback��selfr r r �__init__p s �zOptionParser.__init__c C s |� dd�S )N�_�-)�replace�r �namer r r �_normalize_namew � z OptionParser._normalize_namec C s6 | � |�}t| j�|�t�r| j| �� S td| ���NzUnrecognized option %r)r$ � isinstancer �get�_Option�value�AttributeErrorr" r r r � __getattr__z s zOptionParser.__getattr__c C s8 | � |�}t| j�|�t�r| j| �|�S td| ��r& )r$ r' r r( r) �setr+ �r r# r* r r r � __setattr__� s zOptionParser.__setattr__c C � dd� | j �� D �S )Nc s � � | ]}|j V qd S �N�r# ��.0�optr r r � <genexpr>� � � z(OptionParser.__iter__.<locals>.<genexpr>)r �valuesr r r r �__iter__� s zOptionParser.__iter__c C s | � |�}|| jv S r2 )r$ r r" r r r � __contains__� s zOptionParser.__contains__c C s | � |�S r2 )r, r" r r r � __getitem__� s zOptionParser.__getitem__c C s | � ||�S r2 )r/ r. r r r � __setitem__� r% zOptionParser.__setitem__c C r0 )zJA sequence of (name, value) pairs. .. versionadded:: 3.1 c S s g | ] \}}|j |�� f�qS r �r# r* �r5 r# r6 r r r � <listcomp>� s z&OptionParser.items.<locals>.<listcomp>)r �itemsr r r r rA � s zOptionParser.itemsc C � t dd� | j�� D ��S )zWThe set of option-groups created by ``define``. .. versionadded:: 3.1 c s r1 r2 )� group_namer4 r r r r7 � r8 z&OptionParser.groups.<locals>.<genexpr>)r- r r9 r r r r �groups� s zOptionParser.groupsc s t � fdd�| j�� D ��S )a� The names and values of options in a group. Useful for copying options into Application settings:: from salt.ext.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 s0 � | ]\}}� r � |j kr|j|�� fV qd S r2 )rC r# r* r? ��groupr r r7 � s � � ��z*OptionParser.group_dict.<locals>.<genexpr>��dictr rA )r rF r rE r � group_dict� s �zOptionParser.group_dictc C rB )zLThe names and values of all options. .. versionadded:: 3.1 c s s" � | ] \}}|j |�� fV qd S r2 r> r? r r r r7 � s � �z'OptionParser.as_dict.<locals>.<genexpr>rG r r r r �as_dict� s �zOptionParser.as_dictNFc C s� | � |�} | | jv rtd| | j| jf ��t�d�} | jj} | jjj| kr0| jjj dkr0| j} | jjj} | | kr;d} |du rK|sI|durI|j }nt }|rP|} n| } t || |||||| |d� }|| j| < dS )a; 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. z Option %r already defined in %sr r � N)� file_name�defaultr r �metavar�multiplerC r ) r$ r r rL �sys� _getframe�f_code� co_filename�f_back�co_name� __class__�strr) )r r# rM r r rN rO rF r � normalized�frameZ options_filerL rC �optionr r r r � s6 % � �zOptionParser.defineTc C s� |du rt j}g }tdt|��D ]^}|| �d�s!||d� } nN|| dkr1||d d� } n>|| �d�}|�d�\}}}| �|�}|| jvrT| � � t d| ��| j| } |si| j t krcd}nt d| ��| � |� q|ru| �� |S ) a� 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. N� r z--�=z$Unrecognized command line option: %r�truezOption %r requires a value)rP �argv�range�len� startswith�lstrip� partitionr$ r � print_helpr r r �parse�run_parse_callbacks) r �args�final� remaining�i�argr# �equalsr* rZ r r r �parse_command_line s2 z OptionParser.parse_command_linec C s� dt j�|�i}t|d��}tt|�� �||� W d � n1 s"w Y |D ]}| �|�}|| jv r?| j| � || � q)|rH| � � dS dS )a6 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. .. versionchanged:: 4.4 The special variable ``__file__`` is available inside config files, specifying the absolute path to the config file itself. �__file__�rbN) �os�path�abspath�openr r �readr$ r r- rf )r rq rh Zconfig�fr# rX r r r �parse_config_file. s � � �z OptionParser.parse_config_filec C sl |du rt j}tdt jd |d� td|d� i }| j�� D ] }|�|jg ��|� q t |� � �D ]|\}}|rDtdt j � |� |d� |jdd� d � |D ]_}| �|j�}|jr`|d |j 7 }|jpdd }|jdurv|jd krv|d |j 7 }t�|d �}t|�dks�t|�dkr�|�dd � td||d f |d� |dd� D ] } tdd| f |d� q�qNq2t|d� dS )z@Prints all the command line options to stderr (or another file).NzUsage: %s [OPTIONS]r ��filez Options: z %s options: c S s | j S r2 r3 )rZ r r r �<lambda>U s z)OptionParser.print_help.<locals>.<lambda>)�keyr\ rK z (default %s)�, � z --%-30s %sr[ z%-34s %s� )rP �stderr�printr^ r r9 � setdefaultrC �append�sortedrA rp rq �normpath�sortr$ r# rN r rM �textwrap�wrapr` �insert) r rx Zby_grouprZ �filename�o�prefix� description�lines�liner r r rd H s6 ��zOptionParser.print_helpc C s |r | � � t�d� d S d S )Nr )rd rP �exit�r r* r r r r f s �zOptionParser._help_callbackc C s | j �t�|�� dS )zAAdds a parse callback, to be invoked when option parsing is done.N)r r� r r� �r r r r r �add_parse_callbackk s z OptionParser.add_parse_callbackc C s | j D ]}|� qd S r2 )r r� r r r rf o s �z OptionParser.run_parse_callbacksc C s t | �S )a� 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 )� _Mockabler r r r �mockables s zOptionParser.mockable�NNNNFNN�NT�Tr2 )r r r r r r$ r, r/ r: r; r< r= rA rD rI rJ r rm rv rd r r� rf r� r r r r r j s0 � E + r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) r� a `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 � _originals)r )r �optionsr r r r � s z_Mockable.__init__c C s t | j|�S r2 )�getattrr r" r r r r, � r% z_Mockable.__getattr__c C s6 || j vs J d��t| j|�| j |< t| j||� d S )Nz don't reuse mockable objects)r� r� r �setattrr. r r r r/ � s z_Mockable.__setattr__c C s t | j|| j�|�� d S r2 )r� r r� �popr" r r r � __delattr__� s z_Mockable.__delattr__N)r r r r r r, r/ r� r r r r r� � s r� c @ s� e Zd Ze� Zdeddddddfdd�Zdd� Zdd� Zd d � Z g d �Z d d � Z dddddddddd� Z dZ e�de ej�Zdd� Zdd� Zd d � ZdS ) r) NFc C sR |d u r|rg }|| _ || _|| _|| _|| _|| _|| _| | _|| _t j | _ d S r2 ) r# r r rN rO rL rC r rM r) �UNSET�_value) r r# rM r r rN rO rL rC r r r r r � s z_Option.__init__c C s | j tju r | jS | j S r2 )r� r) r� rM r r r r r* � s z _Option.valuec C s� t j | jt j| jt| jt| ji�| j | j �}| j rTg | _ |� d�D ]1}t | j tj�rJ|�d�\}}}||�}|r<||�n|}| j �t||d �� q!| j �||�� q!n||�| _ | jd urd| �| j � | �� S )N�,�:r[ )�datetime�_parse_datetime� timedelta�_parse_timedeltar � _parse_boolr � _parse_stringr( r rO r� �split� issubclass�numbersZIntegralrc �extendr_ r� r r* )r r* �_parse�part�lor �hir r r re � s* � �� z _Option.parsec C s� | j r.t|t�std| j| jjf ��|D ]}|d ur,t|| j�s,td| j| jjf ��qn|d urFt|| j�sFtd| j| jjt|�f ��|| _| jd urV| �| j� d S d S )Nz(Option %r is required to be a list of %sz+Option %r is required to be a %s (%s given)) rO r' �listr r# r r r� r )r r* �itemr r r r- � s( � ���� �z _Option.set) 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:%Mc C s> | j D ]}z tj�||�W S ty Y qw td| ��)Nz!Unrecognized date/time format: %r)�_DATETIME_FORMATSr� �strptime� ValueErrorr )r r* �formatr r r r� � s � z_Option._parse_datetime�hours�minutes�secondsZ milliseconds� microseconds�days�weeks) �h�m�min�sZsec�ms�us�d�wz-[-+]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][-+]?\d+)?z\s*(%s)\s*(\w*)\s*c C s� zFt �� }d}|t|�k rD| j�||�}|st� �t|�d��}|�d�p&d}| j� ||�}|t jdi ||i��7 }|� � }|t|�k s |W S tyN � w )Nr r[ � r� r ) r� r� r` �_TIMEDELTA_PATTERN�match� Exception�floatrF �_TIMEDELTA_ABBREV_DICTr( �end)r r* �sum�startr� �numZunitsr r r r� s" � �z_Option._parse_timedeltac C s |� � dvS )N)�false�0ru )�lowerr� r r r r� r% z_Option._parse_boolc C s t |�S r2 )r r� r r r r� s z_Option._parse_string)r r r �objectr� r r r* re r- r� r� r� Z_FLOAT_PATTERN�re�compile� IGNORECASEr� r� r� r� r r r r r) � s8 � � � r) Fc C s t j| |||||||d�S )zODefines an option in the global namespace. See `OptionParser.define`. )rM r r rN rO rF r )r� r )r# rM r r rN rO rF r r r r r ' s �r Tc C � t j| |d�S )z]Parses global options from the command line. See `OptionParser.parse_command_line`. �rh )r� rm )rg rh r r r rm 2 � rm c C r� )zYParses global options from a config file. See `OptionParser.parse_config_file`. r� )r� rv )rq rh r r r rv : r� rv c C s t �| �S )ziPrints all the command line options to stderr (or another file). See `OptionParser.print_help`. )r� rd rw r r r rd B s rd c C s t �| � dS )zqAdds a parse callback, to be invoked when option parsing is done. See `OptionParser.add_parse_callback` N)r� r� )r r r r r� J r� r� r� r� r� r2 )!r � __future__r r r r� r� r� rP rp r� Zsalt.ext.tornado.escaper r Zsalt.ext.tornado.logr Zsalt.ext.tornador Zsalt.ext.tornado.utilr r r� r r� r r� r) r� r rm rv rd r� r r r r �<module> s8 E ~ �
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings