File: //usr/lib/python3/dist-packages/certbot/_internal/cli/__pycache__/helpful.cpython-310.pyc
o
6��aPN � @ sN d Z ddlZddlZddlZddlZddlZddlmZ ddlmZ ddl Z ddl
m Z ddl
m Z ddl
m
Z
ddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm Z ddl m Z ddl m Z ddl!m"Z# ddl$m%Z% G dd� d�Z&dS )z$Certbot command line argument parser� N)�Any)�Dict)� crypto_util)�errors)�util)� constants)�hooks)�ARGPARSE_PARAMS_TO_REMOVE)�COMMAND_OVERVIEW)� EXIT_ACTIONS)�HELP_AND_VERSION_USAGE)� SHORT_USAGE)�ZERO_ARG_ACTIONS)�_Default)� add_domains)�CustomHelpFormatter)� flag_default)�HelpfulArgumentGroup)� VERB_HELP)�
VERB_HELP_MAP)�obj)�osc @ s� e Zd ZdZd$dd�Zg d�Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd%d d �Zd d � Zd!d"� Zd#S )&�HelpfulArgumentParserz�Argparse Wrapper.
This class wraps argparse, adding the ability to make --help less
verbose, and request help on specific subcategories at a time, eg
'certbot --help security' for security options.
Fc
C s� ddl m} i d|j�d|j�d|j�d|j�d|j�d|j�d |j�d
|j�d |j �d |j
�d
|j �d|j�d|j �d|j
�d|j�d|j�| _t�tj�j| _g d�}|t| j�| j dg 7 }t|�}|| d g | _|| _|| _| jr�| jd dkr�d| jd< | � � | � d| j�}| � d| j�}t |t �r�t |t �r�|p�|| _ n
t |t!�r�|n|| _ | �"|| j �} | �#| j �| _$i | _%i | _&t'j(d| t)ddgt*d�d �+d �,t*d���d �| _-d | j-_.| d S ) Nr )�main�auth�certonly�run�install�plugins�register�update_account�
unregister�renew�revoke�rollback�
everything�update_symlinks� certificates�delete�enhance)�all�security�paths�
automation�testing�manage�help�--help�-h�certbotz-cz--config� config_filesz"path to config file (default: {0})z and )�prog�usage�formatter_class� args_for_setting_config_path�default_config_files�config_arg_help_messageF)/�certbot._internalr r r r � plugins_cmdr r r! r" r# r$ r& r' r( r) �VERBS� display_obj�NoninteractiveDisplay�sys�stdout� notification�notify�list�COMMANDS_TOPICS� help_topics�detect_defaults�args�determine_verb�prescan_for_flag�
isinstance�bool�help_arg�str�
_usage_string�determine_help_topics�visible_topics�groups�defaults�configargparse� ArgParserr r �format�join�parser�_add_config_file_help)
�selfrH r rG r � HELP_TOPICS� plugin_names�help1�help2� short_usage� r` �?/usr/lib/python3/dist-packages/certbot/_internal/cli/helpful.py�__init__+ s� �������� �
� � �
����
��
z HelpfulArgumentParser.__init__)�command�commands�
subcommand� subcommands�verbsc C sT t dd� tD ��}d}tt�D ]\}}|�dd�}|dj|||d�7 }q|d7 }|S ) Nc s s � | ]}t |�V qd S �N)�len)�.0�vr` r` ra � <genexpr>s s � z:HelpfulArgumentParser._list_subcommands.<locals>.<genexpr>z,The full list of available SUBCOMMANDS is:
�short� z{0:<{length}} {1}
)�lengthzG
You can get more help on a specific subcommand with --help SUBCOMMAND
)�maxr �sortedr �getrV )rZ �longest�text�verb�props�docr` r` ra �_list_subcommandsr s z'HelpfulArgumentParser._list_subcommandsc C s� d|v rd}nd}d|v rd}nd}t }|du r,| �|t||f t � t�d� |S || jv rA| �|| �� � t�d� |S |d krO|t||f 7 }|S t� |i �� d
d �}|r]|n|}|S ) a# Make usage strings late so that plugins can be initialised late
:param plugins: all discovered plugins
:param help_arg: False for none; True for --help; "TOPIC" for --help TOPIC
:rtype: str
:returns: a short usage string for the top of --help TOPIC)
�nginxzH--nginx Use the Nginx plugin for authentication & installationz+(the certbot nginx plugin is not installed)�apachezI--apache Use the Apache plugin for authentication & installationz,(the certbot apache plugin is not installed)Tr r* r6 N)
r
rC r
r r@ �exitrE rx r rr )rZ r rM � nginx_doc�
apache_docr6 �customr` r` ra rO } s*
�
�� z#HelpfulArgumentParser._usage_stringc C sL | j dkr"| jj�� D ]\}}|�d�r!d|v r!| jr t� ng |_q dS dS )z8Make "certbot renew" safe if domains are set in cli.ini.r" � config_file�domainsN)ru rX �_source_to_settings�items�
startswithrG r r� )rZ � parsed_args�source�flagsr` r` ra �&remove_config_file_domains_for_renewal� s
��z<HelpfulArgumentParser.remove_config_file_domains_for_renewalc s: � j �� j�}� j� j |_� j|_� �|� � jr |S � fdd�t|�D �� _ � jdkr<|j
r9t � d�
tj���d|_|j
rK|jrKt � d�
tj���|jsQ|jrV� �|� |jr^� �|� |jrdd|_|jrlt�|� |jr~tdd� |j D ��r~t � d ��|j r�|j r�t � d
��t |j t!�r�t"|j �d kr�t � d ��|S )
z�Parses command line arguments and returns the result.
:returns: parsed command line arguments
:rtype: argparse.Namespace
c s i | ] }|t �� j�|���qS r` )�copy�deepcopyrX � get_default)rj �key�rZ r` ra �
<dictcomp>� s �z4HelpfulArgumentParser.parse_args.<locals>.<dictcomp>r" z {0} cannot be used with renewTz.Flag for non-interactive mode and {0} conflictc s s � | ]}t �|�V qd S rh )r �is_wildcard_domain�rj �dr` r` ra rl � s � z3HelpfulArgumentParser.parse_args.<locals>.<genexpr>zFUsing --allow-subset-of-names with a wildcard domain is not supported.z@Parameters --hsts and --auto-hsts cannot be used simultaneously.� z8Only *one* --key-type type may be provided at this time.)#rX �
parse_argsrH r= ru �funcr� rG �varsrS �force_interactiver �ErrorrV r �FORCE_INTERACTIVE_FLAG�noninteractive_mode�staging�dry_run�set_test_server�csr�
handle_csr� must_staple�staple�validate_hooksr �allow_subset_of_names�anyr� �hsts� auto_hstsrK �key_typerD ri )rZ r� r` r� ra r� � sV
�
�� ��
��z HelpfulArgumentParser.parse_argsc C s� t d�tjf}|jr|j|vrt�d��|j|v r tj|_|jrH| jdvr-t�d| j ��d |_ |_t
�
t j �
|jtjd��rJd|_d|_dS dS dS )zGWe have --staging/--dry-run; perform sanity check and set config.server�serverz'--server value conflicts with --staging)r r" zN--dry-run currently only works with the 'certonly' or 'renew' subcommands (%r)T�*N)r r � STAGING_URIr� r� r r� r� ru �break_my_certs�globr �pathrW �
config_dir� ACCOUNTS_DIR�tos� register_unsafely_without_email)rZ r� �default_serversr` r` ra r� � s
�
�z%HelpfulArgumentParser.set_test_serverc
C s� |j dkr
t�d��|jrt�d��|jdd� \}}t�||�\}}}|D ]}t||� q&|s:t�d|jd ��||f|_dd� |D �}t |j
�} || kr^t� d � d
�
|�d
�
| ����d S ) zProcess a --csr flag.r z�Currently, a CSR file may only be specified when obtaining a new or replacement via the certonly command. Please try the certonly command instead.z1--allow-subset-of-names cannot be used with --csrr � zJUnfortunately, your CSR %s needs to have a SubjectAltName for every domainc S s h | ]}|� � �qS r` )�lowerr� r` r` ra � <setcomp> s z3HelpfulArgumentParser.handle_csr.<locals>.<setcomp>zMInconsistent domain requests:
From the CSR: {0}
From command line/config: {1}z, N)ru r r� r� r� r �import_csr_filer �
actual_csr�setr� �ConfigurationErrorrV rW )
rZ r� �csrfile�contents�typr� r� �domain� csr_domains�config_domainsr` r` ra r� s.
��
��z HelpfulArgumentParser.handle_csrc C sz d| j v s
d| j v rd| _dS t| j �D ]#\}}|| jv r7|}|dkr%d}|dkr+d}|| _| j �|� dS qd| _dS ) z�Determines the verb/subcommand provided by the user.
This function works around some of the limitations of argparse.
r2 r1 r0 Nr r r% r )rH ru � enumerater= �pop)rZ �i�tokenru r` r` ra rI " s
�
z$HelpfulArgumentParser.determine_verbc C sR || j vrdS | j �|�}z| j |d }||v r |W S W dS ty( Y dS w )as Checks cli input for flags.
Check for a flag, which accepts a fixed set of possible arguments, in
the command line; we will use this information to configure argparse's
help correctly. Return the flag's argument, if it has one that matches
the sequence @possible_arguments; otherwise return whether the flag is
present.
Fr� T)rH �index�
IndexError)rZ �flag�possible_arguments�pos�nxtr` r` ra rJ : s
� ��z&HelpfulArgumentParser.prescan_for_flagc O s� |� d�}|tju r| jj|i |�� dS t|t�r'| j|v r"| jn|d }n|}| jr4| j di |��}| j
| rX|| j v rM| j | }|j|i |�� dS | jj|i |�� dS t j
|d< | jj|i |�� dS )a1 Add a new command line argument.
:param topics: str or [str] help topic(s) this should be listed under,
or None for options that don't fit under a specific
topic which will only be shown in "--help all" output.
The first entry determines where the flag lives in the
"--help all" output (None -> "optional arguments").
:param list *args: the names of this argument flag
:param dict **kwargs: various argparse settings for this argument
�actionNr r0 r` )rr r �DeprecatedArgumentActionrX � add_argumentrK rD rM rG �#modify_kwargs_for_default_detectionrQ rR �argparse�SUPPRESS)rZ �topicsrH �kwargsr� �topic�groupr` r` ra �addO s
zHelpfulArgumentParser.addc K sL |� dd�}|tvr$|tv rdnd|d< t� |d< tD ]}|�|d� q|S )a_ Modify an arg so we can check if it was set by the user.
Changes the parameters given to argparse when adding an argument
so we can properly detect if the value was set by the user.
:param dict kwargs: various argparse settings for this argument
:returns: a modified versions of kwargs
:rtype: dict
r� N�
store_true�store�default)rr r r r r r� )rZ r� r� �paramr` r` ra r� | s �
z9HelpfulArgumentParser.modify_kwargs_for_default_detectionc C s t �| jd�}t�|||� dS )a� Adds a deprecated argument with the name argument_name.
Deprecated arguments are not shown in the help. If they are used
on the command line, a warning is shown stating that the
argument is deprecated and no other action is taken.
:param str argument_name: Name of deprecated argument.
:param int nargs: Number of arguments the option takes.
N)� functools�partialr� r �add_deprecated_argument)rZ �
argument_name�num_args�add_funcr` r` ra r� � s z-HelpfulArgumentParser.add_deprecated_argumentr` c K sZ | j | r(| jj|fi |��| j|< | jr(|D ]}| j| j|t| d d� qt| |�S )a� Create a new argument group.
This method must be called once for every topic, however, calls
to this function are left next to the argument definitions for
clarity.
:param str topic: Name of the new argument group.
:param str verbs: List of subcommands that should be documented as part of
this help group / topic
:returns: The new argument group.
:rtype: `HelpfulArgumentGroup`
rm )r0 )rQ rX �add_argument_grouprR rM r� r r )rZ r� rg r� rk r` r` ra � add_group� s
z HelpfulArgumentParser.add_groupc C s4 |� � D ]\}}| j||jd�}|j�||� qdS )z�
Let each of the plugins add its own command line arguments, which
may or may not be displayed as help topics.
)� descriptionN)r� r� �long_description�
plugin_cls�inject_parser_options)rZ r �name� plugin_ep�parser_or_groupr` r` ra �add_plugin_args� s ��z%HelpfulArgumentParser.add_plugin_argsc sX � dkrd� � dkr d� � dkrdd� | j D �S � s"dd� | j D �S � fd d�| j D �S )
z�
The user may have requested help on a topic, return a dict of which
topics to display. @chosen_topic has prescan_for_flag's return type
:returns: dict
r r r% r r* c S s i | ]}||d k�qS )zcertbot-route53:authr` �rj �tr` r` ra r� � � z?HelpfulArgumentParser.determine_help_topics.<locals>.<dictcomp>c S s i | ]}|d �qS �Fr` r� r` r` ra r� � s c s i | ]}||� k�qS r` r` r� �� chosen_topicr` ra r� � r� )rF )rZ r� r` r� ra rP � s z+HelpfulArgumentParser.determine_help_topicsNr� )r` )�__name__�
__module__� __qualname__�__doc__rb rE rx rO r� r� r� r� rI rJ r� r� r� r� r� rP r` r` r` ra r # s$
E "< "-
r )'r� r� r� r� r� r@ �typingr r rT r3 r r r r; r r �#certbot._internal.cli.cli_constantsr r
r r r
r � certbot._internal.cli.cli_utilsr r r r r � certbot._internal.cli.verb_helpr r �certbot._internal.displayr r> �certbot.compatr r r` r` r` ra �<module> s<