Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
local
/
bin
/
dhwp
/
env
/
lib
/
python3.10
/
site-packages
/
cement
/
utils
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: shell.cpython-310.pyc
o Łh"? � @ s� d Z ddlZddlZddlmZ ddlmZmZ ddlmZ ddl m Z ddl m Z m Z mZmZmZmZ dd lmZ dd lmZ d%d ed ede de dee eeef ef f dd�Zdeeee f de de de eeef fdd�Zdeeee f de de defdd�Z d&dededed ede de deee f fd d �Z d'dededede de def d d �Z d'dededede de de f d!d"�Z G d#d$� d$e�Z dS )(zCommon Shell Utilities.� N��getpass)�Popen�PIPE)�Process)�Thread)�Any�Tuple�List�Union�Callable�Optional� )� MetaMixin)�FrameworkErrorT�command�capture�args�kwargs�returnc O sX |� dd�|d< |du r t| g|�R i |��\}}}|||fS t| g|�R i |��}|S )aL Wrapper around ``exec_cmd`` and ``exec_cmd2`` depending on whether capturing output is desired. Defaults to setting the Popen ``shell`` keyword argument to ``True`` (string command rather than list of command and arguments). Arguments: command (str): The command (and arguments) to run. capture (bool): Whether or not to capture output. Other Parameters: args: Additional arguments are passed to ``Popen()``. kwargs: Additional keyword arguments are passed to ``Popen()``. Returns: tuple: When ``capture==True``, returns the ``(stdout, stderror, return_code)`` of the command. int: When ``capture==False``, returns only the ``exitcode`` of the command. Example: .. code-block:: python from cement.utils import shell # execute a command and capture output stdout, stderr, exitcode = shell.cmd('echo helloworld') # execute a command but do not capture output exit_code = shell.cmd('echo helloworld', capture=False) �shellT)�get�exec_cmd� exec_cmd2)r r r r �stdout�stderr�exitcode� r �J/usr/local/bin/dhwp/env/lib/python3.10/site-packages/cement/utils/shell.py�cmd s % r �cmd_argsc O s^ d|� � vr t|d< d|� � vrt|d< t| g|�R i |��}|�� \}}|�� |||jfS )a� Execute a shell call using Subprocess. All additional ``*args`` and ``**kwargs`` are passed directly to ``subprocess.Popen``. See `Subprocess <http://docs.python.org/library/subprocess.html>`_ for more information on the features of ``Popen()``. Args: cmd_args (list): List of command line arguments. Other Parameters: args: Additional arguments are passed to ``Popen()``. kwargs: Additional keyword arguments are passed to ``Popen()``. Returns: tuple: The ``(stdout, stderror, return_code)`` of the command. Example: .. code-block:: python from cement.utils import shell stdout, stderr, exitcode = shell.exec_cmd(['echo', 'helloworld']) r r )�keysr r � communicate�wait� returncode)r r r �procr r r r r r @ s r c O s$ t | g|�R i |��}|�� |jS )a Similar to ``exec_cmd``, however does not capture stdout, stderr (therefore allowing it to print to console). All additional ``*args`` and ``**kwargs`` are passed directly to ``subprocess.Popen``. See `Subprocess <http://docs.python.org/library/subprocess.html>`_ for more information on the features of ``Popen()``. Args: cmd_args (list): List of command line arguments Other Parameters: args: Additional arguments are passed to ``Popen()`` kwargs: Additional keyword arguments are passed to ``Popen()`` Returns: int: The integer return code of the command. Example: .. code-block:: python from cement.utils import shell exitcode = shell.exec_cmd2(['echo', 'helloworld']) )r r# r$ )r r r r% r r r r h s r F�target�start�join�threadc O s< |du rt | ||g|�R i |��S t| ||g|�R i |��S )a� Wrapper around ``spawn_process`` and ``spawn_thread`` depending on desired execution model. Args: target (function): The target function to execute in the sub-process. Keyword Args: start (bool): Call ``start()`` on the process before returning the process object. join (bool): Call ``join()`` on the process before returning the process object. Only called if ``start == True``. thread (bool): Whether to spawn as thread instead of process. Other Parameters: args: Additional arguments are passed to ``Process()`` kwargs: Additional keyword arguments are passed to ``Process()``. Returns: object: The process object returned by Process(). Example: .. code-block:: python from cement.utils import shell def add(a, b): print(a + b) p = shell.spawn(add, args=(12, 27)) p.join() T)� spawn_thread� spawn_process)r& r' r( r) r r r r r �spawn� s 'r, c O �F | |d< t |i |��}|r|s|�� |S |r!|r!|�� |�� |S )a^ A quick wrapper around ``multiprocessing.Process()``. By default the ``start()`` function will be called before the spawned process object is returned. See `MultiProcessing <https://docs.python.org/3/library/multiprocessing.html>`_ for more information on the features of ``Process()``. Args: target (function): The target function to execute in the sub-process. Keyword Args: start (bool): Call ``start()`` on the process before returning the process object. join (bool): Call ``join()`` on the process before returning the process object. Only called if ``start == True``. Other Parameters: args: Additional arguments are passed to ``Process()`` kwargs: Additional keyword arguments are passed to ``Process()``. Returns: object: The process object returned by Process(). Example: .. code-block:: python from cement.utils import shell def add(a, b): print(a + b) p = shell.spawn_process(add, args=(12, 27)) p.join() r& )r r' r( )r& r' r( r r r% r r r r+ � � )�r+ c O r- )a> A quick wrapper around ``threading.Thread()``. By default the ``start()`` function will be called before the spawned thread object is returned See `Threading <https://docs.python.org/3/library/threading.html>`_ for more information on the features of ``Thread()``. Args: target (function): The target function to execute in the thread. Keyword Args: start (bool): Call ``start()`` on the thread before returning the thread object. join (bool): Call ``join()`` on the thread before returning the thread object. Only called if ``start == True``. Other Parameters: args: Additional arguments are passed to ``Thread()``. kwargs: Additional keyword arguments are passed to ``Thread()``. Returns: object: The thread object returned by ``Thread()``. Example: .. code-block:: python from cement.utils import shell def add(a, b): print(a + b) t = shell.spawn_thread(add, args=(12, 27)) t.join() r& )r r' r( )r& r' r( r r �thrr r r r* � r. r* c s� e Zd ZdZG dd� d�Z ddee dededdf� fd d � Zdedefd d �Z dedefd d�Z dedefdd�Z ddd�Z dee fdd�Z ddd�Z� ZS )�Prompta� A wrapper around ``input`` whose purpose is to limit the redundent tasks of gather usr input. Can be used in several ways depending on the use case (simple input, options, and numbered selection). Args: text (str): The text displayed at the input prompt. Example: Simple prompt to halt operations and wait for user to hit enter: .. code-block:: python p = shell.Prompt("Press Enter To Continue", default='ENTER') .. code-block:: text $ python myapp.py Press Enter To Continue $ Provide a numbered list for longer selections: .. code-block:: python p = Prompt("Where do you live?", options=[ 'San Antonio, TX', 'Austin, TX', 'Dallas, TX', 'Houston, TX', ], numbered = True, ) .. code-block:: text Where do you live? 1: San Antonio, TX 2: Austin, TX 3: Dallas, TX 4: Houston, TX Enter the number for your selection: Create a more complex prompt, and process the input from the user: .. code-block:: python class MyPrompt(Prompt): class Meta: text = "Do you agree to the terms?" options = ['Yes', 'no', 'maybe-so'] options_separator = '|' default = 'no' clear = True max_attempts = 99 def process_input(self): if self.input.lower() == 'yes': # do something crazy pass else: # don't do anything... maybe exit? print("User doesn't agree! I'm outa here") sys.exit(1) MyPrompt() .. code-block:: text $ python myapp.py [TERMINAL CLEAR] Do you agree to the terms? [Yes|no|maybe-so] no User doesn't agree! I'm outa here $ echo $? $ 1 c @ s� e Zd ZU dZdZeed< dZee ed< dZ ee ed< dZ eed< d Z e ed < d Zeed < d Ze ed< d Ze ed< d Ze ed< dZeed< dZeed< d Ze ed< d Ze ed< dS )z Prompt.Metazk Optional meta-data (can also be passed as keyword arguments to the parent class). z Tell me someting interesting:�textN�default�options�,�options_separatorF�numberedz$Enter the number for your selection:�selection_textT�auto�case_insensitive�clear� clear_command� � max_attempts�max_attempts_exception�suppress)�__name__� __module__� __qualname__�__doc__r1 �str�__annotations__r2 r r3 �dictr5 r6 �boolr7 r8 r9 r: r; r= �intr> r? r r r r �Metax s rI Nr1 r �kwr c sD |d ur||d< t t| �j|i |�� d | _| jjr | �� d S d S )Nr1 )�superr0 �__init__�input�_metar8 �prompt)�selfr1 r rJ �� __class__r r rL � s �zPrompt.__init__c C s t |�}|S �Nr �rP r1 �resr r r �_get_suppressed_input� s z Prompt._get_suppressed_inputc C s t �|�}|S rS )�builtinsrM rT r r r �_get_unsuppressed_input� s z Prompt._get_unsuppressed_inputc C s( | j jdu r | �|�}|S | �|�}|S )NT)rN r? rV rX rT r r r � _get_input� s �zPrompt._get_inputc C s | j jr t�| j j� d}| j jd urW| j jdu rC|| j j d }d}| j jD ]}||� d|� d� }|d7 }q'|d }|| j j }n| j j }| j j� d|� | j j�� d�}n| j j}| � |� d ��| _ | j dkrv| j j d urv| j j | _ d S | j dkr�d | _ d S d S ) N� Tz � z: � z [�]� )rN r: �os�systemr; r3 r6 r1 r7 r5 r( rY rM r2 )rP r1 �count�option�sepr r r �_prompt� s* �zPrompt._promptc C s d}| j du r||t| jj�kr | jjdu rtd��| j S |d7 }| �� | j du r*q| jjdurw| jjrQz| jjt| j �d | _ W n4 t t fyP d| _ Y qw | jj du rldd� | jjD �}| j � � |vrkd| _ qn | j | jjvrwd| _ q| j du s| � � | j S )zK Prompt the user, and store their input as ``self.input``. r NTz2Maximum attempts exceeded getting valid user inputr[ c S s g | ]}|� � �qS r )�lower)�.0�xr r r � <listcomp>� s �z!Prompt.prompt.<locals>.<listcomp>)rM rH rN r= r> r rd r3 r6 � IndexError� ValueErrorr9 re � process_input)rP �attempt� lower_optionsr r r rO � s@ � �� � z Prompt.promptc C s dS )z� Does not do anything. Is intended to be used in a sub-class to handle user input after it is prompted. Nr )rP r r r rk s zPrompt.process_inputrS )r N)r@ rA rB rC rI r rD r rL rV rX rY rd rO rk � __classcell__r r rQ r r0 s& W5����� )r0 )T)TFF)TF) rC r_ rW r � subprocessr r �multiprocessingr � threadingr �typingr r r r r r � core.metar �core.excr rD rG rH r r r r, r+ r* r0 r r r r �<module> s� ���� �2�� �(�� �#������ �.����� �5����� �4
Save
Cancel