Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
local
/
lib
/
python3.10
/
dist-packages
/
argcomplete
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: finders.cpython-310.pyc
o K�hin � @ s� d dl Z d dlZd dlZd dlmZ d dlmZmZmZm Z m Z m Z m Z ddl mZ ddlmZmZmZmZ ddlmZmZ ddlmZ dd lmZmZm Z m Z e j e j e j e j!e j"e j#e j$hZ%d d � Z&G d d � d e'�Z(G dd� de(�Z)dS )� N)�Mapping)�Callable�Dict�List�Optional�Sequence�TextIO�Union� )�io)� BaseCompleter�ChoicesCompleter�FilesCompleter�SuppressCompleter)�debug� mute_stderr)� split_line)�IntrospectiveArgumentParser�action_is_greedy�action_is_open�action_is_satisfiedc C s | � |�S �N�� startswith)� completion�prefix� r �>/usr/local/lib/python3.10/dist-packages/argcomplete/finders.py�default_validator s r c @ sR e Zd ZdZddddde� dfdd�Zdejddddde� fdej de e e f d e d ee d eee d ee d e dee deddfdd�Zdd� Zdd� Zdd� Zdd� Zdd � Zd d � Zed d � �Zd!d"� Zd#e ej d$ej d%e de e fd&d'�Z d(d)� Z d*e e de e fd+d,�Z d*e e d-e d.ee! de e fd/d0�Z"d1d2� Z#d3d4� Z$dS )5�CompletionFindera Inherit from this class if you wish to override any of the stages below. Otherwise, use ``argcomplete.autocomplete()`` directly (it's a convenience instance of this class). It has the same signature as :meth:`CompletionFinder.__call__()`. NTFc C s^ || _ || _|| _|d u rt}|| _|| _d| _i | _|| _|d u r*t j � d�dk}|| _ d S )NF�_ARGCOMPLETE_SUPPRESS_SPACE�1) �_parser�always_complete_options�excluder � validator�print_suppressed� completing�_display_completions�default_completer�os�environ�get� append_space)�self�argument_parserr# r$ r% r& r) r- r r r �__init__( s zCompletionFinder.__init__r/ r# � exit_method� output_streamr$ r% r& r- r) �returnc sZ �j ||||||| d� dtjvrdS ��� |du r1tj�d�} | dur1td�| �� t| d�}|du rOzt�dd�}W n t yN td� |d � Y nw |dusUJ �tj�d d ��t ��d krntd j�d �� |d � tj�d�� � r�t � �d kr�tdj� d �� |d � tjd } t tjd �} t | | �\} }}}}t tjd �d }||d� }|r�|d �j jv r�d|v r�|�|�dd �d � td�| �d�| �d�| �d�|�d�|�d|� ��||| |�}� r��fdd��j�� D ��� �fd d �|D �}tj�d �d k�r�fd d �|D �}td!|� |���|�� |�� tj�� |d� dS )"a� :param argument_parser: The argument parser to autocomplete on :param always_complete_options: Controls the autocompletion of option strings if an option string opening character (normally ``-``) has not been entered. If ``True`` (default), both short (``-x``) and long (``--x``) option strings will be suggested. If ``False``, no option strings will be suggested. If ``long``, long options and short options with no long variant will be suggested. If ``short``, short options and long options with no short variant will be suggested. :param exit_method: Method used to stop the program after printing completions. Defaults to :meth:`os._exit`. If you want to perform a normal exit that calls exit handlers, use :meth:`sys.exit`. :param exclude: List of strings representing options to be omitted from autocompletion :param validator: Function to filter all completions through before returning (called with two string arguments, completion and prefix; return value is evaluated as a boolean) :param print_suppressed: Whether or not to autocomplete options that have the ``help=argparse.SUPPRESS`` keyword argument set. :param append_space: Whether to append a space to unique matches. The default is ``True``. .. note:: If you are not subclassing CompletionFinder to override its behaviors, use :meth:`argcomplete.autocomplete()` directly. It has the same signature as this method. Produces tab completions for ``argument_parser``. See module docs for more info. Argcomplete only executes actions if their class is known not to have side effects. Custom action classes can be added to argcomplete.safe_actions, if their values are wanted in the ``parsed_args`` completer argument, or their execution is otherwise desirable. )r# r$ r% r& r- r) � _ARGCOMPLETEN� _ARGCOMPLETE_STDOUT_FILENAMEzUsing output file {}�w� z)Unable to open fd 8 for writing, quittingr �_ARGCOMPLETE_IFS� z%Invalid value for IFS, quitting [{v}])�v�_ARGCOMPLETE_DFSz%Invalid value for DFS, quitting [{v}]� COMP_LINE� COMP_POINTr �=z LINE: {!r}z POINT: {!r}z PREQUOTE: {!r}z PREFIX: {!r}z SUFFIX: {!r}z WORDS:c s& i | ]\}}||r|� � d �nd�qS )� � ��replace)�.0�key�value)�ifsr r � <dictcomp>� s �z-CompletionFinder.__call__.<locals>.<dictcomp>c s$ g | ]}� � |��|�p d f��qS )r@ )�joinr, )rC rD )�dfs�display_completionsr r � <listcomp>� s $ z-CompletionFinder.__call__.<locals>.<listcomp>�_ARGCOMPLETE_SHELL�zshc s" g | ] }|� d � j �|�� ��qS )�:)r( r, �rC �c�r. r r rK � s " z Returning completions:)r0 r* r+ �_init_debug_streamr, r �format�open�fdopen� Exception�len�intr r" � prefix_chars�append�split�_get_completionsr( �items�writerH �flush�_io� debug_stream)r. r/ r# r1 r2 r$ r% r& r- r) �filename� comp_line� comp_point�cword_prequote� cword_prefix� cword_suffix� comp_words�last_wordbreak_pos�start� completionsr )rI rJ rF r. r �__call__@ s| *� � � � zCompletionFinder.__call__c C s8 z t �dd�t_W n ty tjt_Y nw t� dS )a Initialize debug output stream By default, writes to file descriptor 9, or stderr if that fails. This can be overridden by derived classes, for example to avoid clashes with file descriptors being used elsewhere (such as in pytest). � r6 N)r* rU r` ra rV �sys�stderrr rQ r r r rR � s � z#CompletionFinder._init_debug_streamc C s� | � � }t�� }d| _z/td|dd � � t� � | jj|dd � |d�}W d � n1 s/w Y td|� W n tyW } ztdt |�t |�d� W Y d }~nd }~ww d| _d |v rbd| _ | � |||�} | � | �} | �| ||�} | S ) NTzinvoking parser withr )� namespacez parsed args:z exceptionzwhile parsing argsFz--)�_patch_argument_parser�argparse� Namespacer' r r r" �parse_known_args� BaseException�type�strr# �collect_completions�filter_completions�quote_completions) r. rh rf re ri �active_parsers� parsed_args�a�erk r r r r\ � s( �"�� z!CompletionFinder._get_completionsc sF g | _ g | _| � � �fdd���| j� td| j � td| j� | j S )a� Since argparse doesn't support much introspection, we monkey-patch it to replace the parse_known_args method and all actions with hooks that tell us which action was last taken or about to be taken, and let us have the parser figure out which subparsers need to be activated (then recursively monkey-patch those). We save all active ArgumentParsers to extract all their possible option names later. c s� � j �| � � j�| � t| t�rd S d}t|t| jfi �| _| jD ] }t|d�r*q"G � �fdd�d|j�}|j|_ |j |_ ||_q"d S )N�(MonkeyPatchedIntrospectiveArgumentParser� _orig_classc s e Zd Zd� �fdd� ZdS )zPCompletionFinder._patch_argument_parser.<locals>.patch.<locals>.IntrospectActionNc s� t d| � t d||||� t d| j� t d| j� � js'| j||||d� d S t| jtj�rFt d� �| j|d � | j||||d� d S | jtv r_| j sT� j � | � | j||||d� d S d S )NzAction stub called onz args:z orig class:z orig callable:)� option_stringz:orig class is a subparsers action: patching and running itr ) r r� �_orig_callabler' � issubclassrr �_SubParsersAction�_name_parser_map� safe_actions�option_strings�visited_positionalsrZ )r. �parserrp �valuesr� �� completer�patchr r rl s �zYCompletionFinder._patch_argument_parser.<locals>.patch.<locals>.IntrospectAction.__call__r )�__name__� __module__� __qualname__rl r r� r r �IntrospectAction s r� ) r� rZ r{ � isinstancer rv � __class__�_actions�hasattrr� rl r� )r� � classname�actionr� r� r r r� � s �z6CompletionFinder._patch_argument_parser.<locals>.patchzActive parsers:zVisited positionals:)r{ r� r" r rQ r r� r rq � s ' z'CompletionFinder._patch_argument_parserc s� i }|j �� D ]}|j | }|�|g ��|� q|�� D ]}||j |j D ]}|�� �r5|jp1d| j|< q&q � fdd�|j �� D �}|S )Nr@ c � g | ] }|� � �r|�qS r r )rC �subcmd�rf r r rK ) � z?CompletionFinder._get_subparser_completions.<locals>.<listcomp>) �choices�keys� setdefaultrZ �_get_subactions�destr �helpr( ) r. r� rf �aliases_by_parserrD �pr� �aliasrk r r� r �_get_subparser_completions s ��z+CompletionFinder._get_subparser_completionsc sz t � �dks | jdu r� fdd�|jD �S dd� |jD �}dd� |jD �}| jdkr0|r.|S |S | jdkr;|r9|S |S g S ) Nr Tc r� r r �rC �optr� r r rK . r� z5CompletionFinder._include_options.<locals>.<listcomp>c S s g | ] }t |�d kr|�qS �� �rW r� r r r rK / � c S s g | ] }t |�d kr|�qS r� r� r� r r r rK 0 r� �long�short)rW r# r� )r. r� rf � long_opts� short_optsr r� r �_include_options, s z!CompletionFinder._include_optionsc C s� |j D ]}|jr|jD ]}|�|�r|jpd| j|< q qg }|j D ]1}| js=t|dd �}t|t�r6|� � r6q!|jt j kr=q!| � ||�sDq!t|t j �sR|| �||�7 }q!|S )Nr@ r� )r� r� r r� r( r& �getattrr� r �suppressrr �SUPPRESS�_action_allowedr� r� )r. r� rf r� r� �option_completionsr� r r r �_get_option_completions7 s( � �z(CompletionFinder._get_option_completionsc C s( |j �| g �D ] }||jv r dS qdS �NFT)�_action_conflictsr, �_seen_non_default_actions)r� r� �conflict_actionr r r r� L s �z CompletionFinder._action_allowedc sf t djt|j�|jd�� |o|d |jv � d�� fdd�|jD �}|r<t|�dks.J d��t d |d d � i | _g }n� rMd |v rK|�d �\�}}n|S d }|pS|jD ]�} | jsot| �r_d }|sot | �rot| �sot d| � qTt d| | j � t | dd �} | d u r�| j d ur�t | tj�s�t| j �} n t | tj�s�| j} | �r0t | t�r�| �� r�qTt| �r�| || ||d�} t | t�r�| �� D ]\} } | �| |�r�|�| � | | j| < q�nM| D ] } | �| |�r�|�| � t | t�r�| jp�d| j| < q�d| j| < q�n)t d� td�D ] }| �||�}|d u �r n| �||��r d| j|< |�|� q���r+�fdd�|D �}t d|� qT|S )NzActive actions (L={l}): {a})�lr} r r@ c s g | ] }t |� �r|�qS r )r )rC �x)� isoptionalr r rK Z r� z<CompletionFinder._complete_active_option.<locals>.<listcomp>r z expect at most 1 greedy actionz Resetting completions becausez must consume the next argumentr> FT�SkippingzActivating completion forr� )r r� r� r| zICompleter is not callable, trying the readline completer protocol insteadi' c s g | ]}� d | �qS )r> r )rC r )�optional_prefixr r rK � � z Completions:) r rS rW �active_actionsrY r( � partitionr� r r r� r� r� r� rr r� r r) r r� �callabler r] r% rZ r� �range�complete)r. r� �next_positionalrf r| rk �greedy_actions�_� complete_remaining_positionals� active_actionr� �completer_outputr � description�i�next_completionr )r� r� r �_complete_active_optionU s� � �� �� � �z(CompletionFinder._complete_active_optionr{ r| rf c C s� g }t d|� |d }t d|� | js t|�dkr(|d |jv r(|| �||�7 }t d|� | �� }t d|� t|tj�rD|| � ||�7 }| � |||||�}t d|� t d| j � |S ) a0 Visits the active parsers and their actions, executes their completers or introspects them to collect their option strings. Returns the resulting completions as a list of strings. This method is exposed for overriding in subclasses; there is no need to use it directly. zall active parsers:���zactive_parser:r zoptional options:znext_positional:zactive options:zdisplay completions:) r r# rW rY r� �_get_next_positionalr� rr r� r� r� r( )r. r{ r| rf rk � active_parserr� r r r rx � s" � z$CompletionFinder.collect_completionsc C sz | j d }| jd }|�� }|sdS ||kr|d S d}tt|��D ] }|| |kr, nq"|d t|�k r;||d S dS )z> Get the next positional action if it exists. r� Nr r )r{ r� �_get_positional_actionsr� rW )r. r� �last_positional�all_positionalsr� r r r r� � s � z%CompletionFinder._get_next_positionalrk c C s: g }|D ]}| j dur|| j v rq||vr|�|� q|S )z� De-duplicates completions and excludes those specified by ``exclude``. Returns the filtered completions as a list. This method is exposed for overriding in subclasses; there is no need to use it directly. N)r$ rZ )r. rk �filtered_completionsr r r r ry � s �z#CompletionFinder.filter_completionsre ri c s@ d}|dkr� dur� fdd�|D �}|d7 }n|dkr |d7 }t j�d �d v r+d}n |d kr8d}d d� |D �}t j�d �d krId}|�dd�}nd}t j�d �dkrW|d7 }g }|D ]#}|}|D ] } |�| || �}qa|�|� || jv r~| j| | j|< q[| jr�d} t|�dkr�|d d | vr�|dkr�|d d7 < |S )a� If the word under the cursor started with a quote (as indicated by a nonempty ``cword_prequote``), escapes occurrences of that quote character in the completions, and adds the quote to the beginning of each completion. Otherwise, escapes all characters that bash splits words on (``COMP_WORDBREAKS``), and removes portions of completions before the first colon if (``COMP_WORDBREAKS``) contains a colon. If there is only one completion, and it doesn't end with a **continuation character** (``/``, ``:``, or ``=``), adds a space after the completion. This method is exposed for overriding in subclasses; there is no need to use it directly. �\r@ Nc s g | ] }|� d d� �qS )r Nr rO �ri r r rK r� z6CompletionFinder.quote_completions.<locals>.<listcomp>z();<>|&!`$* "'�"z"`$!rL )�tcsh�fish�'c S s g | ]}|� d d��qS )r� z'\''rA rO r r r rK r� � powershell�`rM rN z=/:r r r� r? )r* r+ r, rB rZ r( r- rW ) r. rk re ri � special_chars� escape_char�escaped_completionsr �escaped_completion�char�continuation_charsr r� r rz � sB � z"CompletionFinder.quote_completionsc sn |dkr)t ��\}� }}}|�dtjd � | �|� ||�}� �fdd�|D �| _|t| j�k r5| j| S dS )ap Alternate entry point for using the argcomplete completer in a readline-based REPL. See also `rlcompleter <https://docs.python.org/3/library/rlcompleter.html#completer-objects>`_. Usage: .. code-block:: python import argcomplete, argparse, readline parser = argparse.ArgumentParser() ... completer = argcomplete.CompletionFinder(parser) readline.set_completer_delims("") readline.set_completer(completer.rl_complete) readline.parse_and_bind("tab: complete") result = input("prompt> ") r c s g | ] }�|t � �d � �qS r r� )rC �match�rf �textr r rK H s z0CompletionFinder.rl_complete.<locals>.<listcomp>N)r �insertrn �argvr\ � _rl_matchesrW )r. r� �statere rg rh �first_colon_pos�matchesr r� r � rl_complete3 s z CompletionFinder.rl_completec C s | j S )zr This function returns a mapping of completions to their help strings for displaying to the user. )r( rQ r r r �get_display_completionsO s z(CompletionFinder.get_display_completions)%r� r� r� �__doc__r r0 r* �_exitrr �ArgumentParserr �boolrw r r r r r rl rR r\ rq r� r� r� � staticmethodr� r� r rs rx r� ry rX rz r� r� r r r r r ! s� ��� ��� ��� � � � : T��� � ��� �B r c @ s e Zd Zedd� �ZdS )�ExclusiveCompletionFinderc C s< t �| |�sdS tjtjf}| j|v rdS | |jvr dS dS r� )r r� rr � _AppendAction�_AppendConstActionr� r� )r� r� �append_classesr r r r� W s z)ExclusiveCompletionFinder._action_allowedN)r� r� r� r� r� r r r r r� V s r� )*rr r* rn �collections.abcr �typingr r r r r r r r@ r r` � completersr r r r r r �lexersr �packages._argparser r r r � _StoreAction�_StoreConstAction�_StoreTrueAction�_StoreFalseActionr� r� � _CountActionr� r �objectr r� r r r r �<module> s2 $ � 9
Save
Cancel