File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/setuptools/_vendor/autocommand/__pycache__/autoparse.cpython-310.pyc
Back
o ;jz- � @ s d dl Z d dlmZ d dlmZmZmZ d dlm Z d dl m Z d dl m Z d dlmZ d dlmZ ejZG d d � d e�ZG d d � d e�ZG d d� de�ZG dd� de�ZG dd� de�Zdd� Zdd� Zdd� Zed�Z dd� Z d"ddd dd �d d �Z e d d!� �Z dS )#� N)�compile)� signature�getdoc� Parameter)�ArgumentParser)�contextmanager)�wraps)�IOBase)�AutocommandErrorc @ � e Zd ZdZdS )�AnnotationErrorzEAnnotation error: annotation must be a string, type, or tuple of bothN��__name__� __module__� __qualname__�__doc__� r r �\/opt/saltstack/salt/lib/python3.10/site-packages/setuptools/_vendor/autocommand/autoparse.pyr � r c @ r )�PositionalArgErrorzQ Postional Arg Error: autocommand can't handle postional-only parameters Nr r r r r r # r r c @ r )� KWArgErrorz:kwarg Error: autocommand can't handle a **kwargs parameterNr r r r r r ) r r c @ r )�DocstringErrorzDocstring errorNr r r r r r - r r c @ r )�TooManySplitsErrorz� The docstring had too many ---- section splits. Currently we only support using up to a single split, to split the docstring into description and epilog parts. Nr r r r r r 1 r r c C s� | t u rdS t| �r| dfS t| t�rd| fS t| t�rNz| \}}W n ty3 } zt| �|�d}~ww t|�rAt|t�rA||fS t|t�rNt|�rN||fS t| ��)z� Given an annotation, return the (type, description) for the parameter. If you provide an annotation that is somehow both a string and a callable, the behavior is undefined. )NNN)�_empty�callable� isinstance�str�tuple� ValueErrorr )� annotationZarg1Zarg2�er r r �_get_type_description9 s$ ��r! c C s� | j | ju r t| ��| j | ju rt| ��i }d}t| j�\}}| j}|du r0|tdhvr0t |�}|tur:||d< d}|durb|t u rT|rH|tu rMd|d< nd|d< d}nt |t �r^t |d< n||d< | j | ju rld |d < |durt||d < g } | j} |r�| d | d �� fD ]} | |vr�|�| � | �d �| �� nq�t| �dks�| s�| �d�| �� | |d< n| �| � |j| i |�� |r�|t u r�|jd�| �d| |tur�|ndd� dS dS dS )a� Add the argument(s) to an ArgumentParser (using add_argument) for a given parameter. used_char_args is the set of -short options currently already in use, and is updated (if necessary) by this function. If add_nos is True, this will also add an inverse switch for all boolean options. For instance, for the boolean parameter "verbose", this will create --verbose and --no-verbose. FN�defaultT� store_true�action� store_false�type�*�nargs�helpr z-{}� z--{}�destz--no-{}� store_const)r$ r+ �const)�kindZPOSITIONAL_ONLYr Z VAR_KEYWORDr r! r r" r r& �boolr r r ZVAR_POSITIONAL�name�swapcase�add�append�format�len� add_argument) �param�parser�used_char_args�add_nosZarg_specZ is_optionZarg_type� descriptionr" �flagsr0 Zletterr r r �_add_argumentsS s` � ��r= c C sD t ||d�}dh}t| j�� dd� d�}|D ] }t||||� q|S )zE Given the signature of a function, create an ArgumentParser )r; �epilog�hc S s t | j�dkS �Nr* )r5 r0 )r7 r r r �<lambda>� s z make_parser.<locals>.<lambda>)�key)r �sorted� parameters�valuesr= )�func_sigr; r> r: r8 r9 �paramsr7 r r r � make_parser� s �rH z\n\s*-{4,}\s*\nc C sL | du rdS t �| �}t|�dkr| dfS t|�dkr#|d |d fS t� �)zH Given a docstring, parse it into a description and epilog part N)� rI r* rI � r )�_DOCSTRING_SPLIT�splitr5 r )Z docstring�partsr r r �parse_docstring� s rN F�r; r> r: r8 c sz �du r � ���fdd�S t ���tt���\}}�du r(t��p"|�p%|� ��t��d���fdd� �}�|_�|_|S )a This decorator converts a function that takes normal arguments into a function which takes a single optional argument, argv, parses it using an argparse.ArgumentParser, and calls the underlying function with the parsed arguments. If it is not given, sys.argv[1:] is used. This is so that the function can be used as a setuptools entry point, as well as a normal main function. sys.argv[1:] is not evaluated until the function is called, to allow injecting different arguments for testing. It uses the argument signature of the function to create an ArgumentParser. Parameters without defaults become positional parameters, while parameters *with* defaults become --options. Use annotations to set the type of the parameter. The `desctiption` and `epilog` parameters corrospond to the same respective argparse parameters. If no description is given, it defaults to the decorated functions's docstring, if present. If add_nos is True, every boolean option (that is, every parameter with a default of True/False or a type of bool) will have a --no- version created as well, which inverts the option. For instance, the --verbose option will have a --no-verbose counterpart. These are not mutually exclusive- whichever one appears last in the argument list will have precedence. If a parser is given, it is used instead of one generated from the function signature. In this case, no parser is created; instead, the given parser is used to parse the argv argument. The parser's results' argument names must match up with the parameter names of the decorated function. The decorated function is attached to the result as the `func` attribute, and the parser is attached as the `parser` attribute. Nc s t | ��� �d�S )NrO )� autoparse)�f)r: r; r> r8 r r rA s �zautoparse.<locals>.<lambda>c sF | d u r t jdd � } ��� }|j�t��| ��� � |ji |j��S r@ ) �sys�argvZ bind_partialZ arguments�update�vars� parse_args�args�kwargs)rS Z parsed_args)�funcrF r8 r r �autoparse_wrapper" s z$autoparse.<locals>.autoparse_wrapper�N)r rN r rH r rY r8 )rY r; r> r: r8 Zdocstr_descriptionZ docstr_epilogrZ r )r: r; r> rY rF r8 r rP � s (�rP c o s^ � t | tttf�r*t| g|�R i |��� }|V W d � dS 1 s#w Y dS | V dS )a] This context manager allows you to open a filename, if you want to default some already-existing file object, like sys.stdout, which shouldn't be closed at the end of the context. If the filename argument is a str, bytes, or int, the file object is created via a call to open with the given *args and **kwargs, sent to the context, and closed at the end of the context, just like "with open(filename) as f:". If it isn't one of the openable types, the object simply sent to the context unchanged, and left unclosed at the end of the context. Example: def work_with_file(name=sys.stdout): with smart_open(name) as f: # Works correctly if name is a str filename or sys.stdout print("Some stuff", file=f) # If it was a filename, f is closed at the end here. N)r r �bytes�int�open)Zfilename_or_filerW rX �filer r r � smart_open7 s �"� r` r[ ) rR �rer Z compile_regex�inspectr r r �argparser � contextlibr � functoolsr �ior Zautocommand.errorsr �emptyr r r r r r r! r= rH rK rN rP r` r r r r �<module> s8 l� �O
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings