File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/parallels.cpython-310.pyc
Back
o ;j O � @ s: d Z ddlZddlZddlZddlZddlZddlZddlm Z m Z dZ ddiZ e� e�Ze�dej�Zdd � Zd d � Zd3d d �Zd3dd�Zd4dd�Zd5dd�Zd6dd�Zd6dd�Zd6dd�Zd7dd �Z d6d d �Z d6d d �Z d6d!d"�Z d6d#d�Z d7d$d%�Z!d7d&d'�Z"d8d)d*�Z#d9d+d,�Z$d:d-d.�Z%d;d/d0�Z&d6d1d2�Z'dS )<a� Manage Parallels Desktop VMs with ``prlctl`` and ``prlsrvctl``. Only some of the prlctl commands implemented so far. Of those that have been implemented, not all of the options may have been provided yet. For a complete reference, see the `Parallels Desktop Reference Guide <http://download.parallels.com/desktop/v9/ga/docs/en_US/Parallels%20Command%20Line%20Reference%20Guide.pdf>`_. This module requires the prlctl binary to be installed to run most functions. To run parallels.prlsrvctl, the prlsrvctl binary is required. What has not been implemented yet can be accessed through ``parallels.prlctl`` and ``parallels.prlsrvctl`` (note the preceding double dash ``--`` as necessary): .. code-block:: bash salt '*' parallels.prlctl installtools macvm runas=macdev salt -- '*' parallels.prlctl capture 'macvm --file macvm.display.png' runas=macdev salt -- '*' parallels.prlsrvctl set '--mem-limit auto' runas=macdev .. versionadded:: 2016.3.0 � N)�CommandExecutionError�SaltInvocationErrorZ parallels�exec_�execzB{?([0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12})}?c C s: t | t�r t�| �S t | ttf�rdd� | D �S t| �gS )z* Return args as a list of strings c S s g | ]}t |��qS � )�str)�.0�argr r �J/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/parallels.py� <listcomp>4 s z#_normalize_args.<locals>.<listcomp>)� isinstancer �shlex�split�tuple�list)�argsr r r �_normalize_args, s r c C sD g }t �t| �D ]}|�� r|�|�d��d�� qttt |���S )a� Return the set of GUIDs found in guid_string :param str guid_string: String containing zero or more GUIDs. Each GUID may or may not be enclosed in {} Example data (this string contains two distinct GUIDs): PARENT_SNAPSHOT_ID SNAPSHOT_ID {a5b8999f-5d95-4aff-82de-e515b0101b66} {a5b8999f-5d95-4aff-82de-e515b0101b66} *{a7345be5-ab66-478c-946e-a6c2caf14909} r �{}) �re�finditer� GUID_REGEX�groups�append�group�strip�sortedr �set)Z guid_stringZguidsZ found_guidr r r � _find_guids9 s �r c C �@ t jj�d�s td��d| g}|r|�t|�� td ||d�S )a Execute a prlsrvctl command .. versionadded:: 2016.11.0 :param str sub_cmd: prlsrvctl subcommand to execute :param str args: The arguments supplied to ``prlsrvctl <sub_cmd>`` :param str runas: The user that the prlsrvctl command will be run as Example: .. code-block:: bash salt '*' parallels.prlsrvctl info runas=macdev salt '*' parallels.prlsrvctl usb list runas=macdev salt -- '*' parallels.prlsrvctl set '--mem-limit auto' runas=macdev � prlsrvctlz prlsrvctl utility not available�cmd.run��runas��salt�utils�path�whichr �extendr Z__salt__�Zsub_cmdr r" �cmdr r r r N s r c C r )a� Execute a prlctl command :param str sub_cmd: prlctl subcommand to execute :param str args: The arguments supplied to ``prlctl <sub_cmd>`` :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.prlctl user list runas=macdev salt '*' parallels.prlctl exec 'macvm uname' runas=macdev salt -- '*' parallels.prlctl capture 'macvm --file macvm.display.png' runas=macdev �prlctlz prlctl utility not availabler r! r# r) r r r r+ q s r+ Fc C s^ |du rg }nt |�}| r|�| g� |r|�d� |r!|�d� |r(|�d� td||d�S )a� List information about the VMs :param str name: Name/ID of VM to list .. versionchanged:: 2016.11.0 No longer implies ``info=True`` :param str info: List extra information :param bool all: List all non-template VMs :param tuple args: Additional arguments given to ``prctl list`` :param str runas: The user that the prlctl command will be run as :param bool template: List the available virtual machine templates. The real virtual machines will not be included in the output .. versionadded:: 2016.11.0 Example: .. code-block:: bash salt '*' parallels.list_vms runas=macdev salt '*' parallels.list_vms name=macvm info=True runas=macdev salt '*' parallels.list_vms info=True runas=macdev salt '*' parallels.list_vms ' -o uuid,status' all=True runas=macdev Nz--infoz--all� --templater r! )r r( r r+ )�name�info�allr r" �templater r r �list_vms� s ' r1 c C sH t jj�| �dt jj�|�g}|r|�d� |r |�d� td||d�S )aM Clone a VM .. versionadded:: 2016.11.0 :param str name: Name/ID of VM to clone :param str new_name: Name of the new VM :param bool linked: Create a linked virtual machine. :param bool template: Create a virtual machine template instead of a real virtual machine. :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.clone macvm macvm_new runas=macdev salt '*' parallels.clone macvm macvm_templ template=True runas=macdev �--namez--linkedr, �cloner! �r$ r% �data�decoder r+ )r- �new_nameZlinkedr0 r" r r r r r3 � s r3 c C � t dtjj�| �|d�S )a* Delete a VM .. versionadded:: 2016.11.0 :param str name: Name/ID of VM to clone :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.exec macvm 'find /etc/paths.d' runas=macdev �deleter! �r+ r$ r% r5 r6 �r- r" r r r r9 � s r9 c C s4 t | d|d��� }|D ] }d| � �|v r dS q dS )a Query whether a VM exists .. versionadded:: 2016.11.0 :param str name: Name/ID of VM :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.exists macvm runas=macdev T)r. r" zName: F)r1 � splitlines)r- r" Zvm_infoZ info_liner r r �exists s �r= c C r8 )z� Start a VM :param str name: Name/ID of VM to start :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.start macvm runas=macdev �startr! r: r; r r r r> � r> c C s, t jj�| �g}|r|�d� td||d�S )af Stop a VM :param str name: Name/ID of VM to stop :param bool kill: Perform a hard shutdown :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.stop macvm runas=macdev salt '*' parallels.stop macvm kill=True runas=macdev z--kill�stopr! r4 )r- �killr" r r r r r@ 0 s r@ c C r8 )a5 Restart a VM by gracefully shutting it down and then restarting it :param str name: Name/ID of VM to restart :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.restart macvm runas=macdev �restartr! r: r; r r r rB M s rB c C r8 )a& Reset a VM by performing a hard shutdown and then a restart :param str name: Name/ID of VM to reset :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.reset macvm runas=macdev �resetr! r: r; r r r rC a r? rC c C r8 )a Status of a VM :param str name: Name/ID of VM whose status will be returned :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.status macvm runas=macdev �statusr! r: r; r r r rD t r? rD c C s, t jj�| �g}|�t|�� td||d�S )a` Run a command on a VM :param str name: Name/ID of VM whose exec will be returned :param str command: Command to run on the VM :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.exec macvm 'find /etc/paths.d' runas=macdev r r! )r$ r% r5 r6 r( r r+ )r- Zcommandr" r r r r r � s c C s t jj�| �} t�t|�stdt jj�|�� d���td| d|g|d�}|s1td| � d|� d���z t jj � |�}W n t jj j yW } zt � d |� i }W Y d }~nd }~ww t|t�rj|�d d �}|d u rid }nt � d |� d }|s~|r~td�|| ���t jj�|�S )aY Attempt to convert a snapshot ID to a snapshot name. If the snapshot has no name or if the ID is not found or invalid, an empty string will be returned :param str name: Name/ID of VM whose snapshots are inspected :param str snap_id: ID of the snapshot :param bool strict: Raise an exception if a name cannot be found for the given ``snap_id`` :param str runas: The user that the prlctl command will be run as Example data .. code-block:: yaml ID: {a5b8999f-5d95-4aff-82de-e515b0101b66} Name: original Date: 2016-03-04 10:50:34 Current: yes State: poweroff Description: original state CLI Example: .. code-block:: bash salt '*' parallels.snapshot_id_to_name macvm a5b8999f-5d95-4aff-82de-e515b0101b66 runas=macdev z Snapshot ID "z" is not a GUID� snapshot-list�--idr! �No snapshots for VM "z " have ID "�"z:Could not interpret snapshot data returned from prlctl: %sN�Name� z^Could not interpret snapshot data returned from prlctl: data is not formed as a dictionary: %sz>Could not find a snapshot name for snapshot ID "{}" of VM "{}")r$ r% r5 r6 r �matchr r r+ ZyamlZ safe_loadZ YAMLError�log�warningr �dict�get�format)r- �snap_id�strictr" r. r5 �err� snap_namer r r �snapshot_id_to_name� s@ # � �� ����rU c C s� t jj�| �} t jj�|�}td| |d�}t|�}g }|D ]}t| ||d�|kr-|�|� q |s;td| � d|� d���t |�dkrE|d S d� | |�}|rQt|��t � |� |S ) aa Attempt to convert a snapshot name to a snapshot ID. If the name is not found an empty string is returned. If multiple snapshots share the same name, a list will be returned :param str name: Name/ID of VM whose snapshots are inspected :param str snap_name: Name of the snapshot :param bool strict: Raise an exception if multiple snapshot IDs are found :param str runas: The user that the prlctl command will be run as CLI Example: .. code-block:: bash salt '*' parallels.snapshot_id_to_name macvm original runas=macdev rE r! rG z " have name "rH � r z-Multiple snapshots for VM "{}" have name "{}") r$ r% r5 r6 r+ r rU r r �lenrP rL rM ) r- rT rR r" r. �snap_idsZ named_idsrQ Z multi_msgr r r �snapshot_name_to_id� s, �� � rY Tc C s4 t jj�|�}t�t|�r|�d�S t| |||d�S )ak Validate snapshot name and convert to snapshot ID :param str name: Name/ID of VM whose snapshot name is being validated :param str snap_name: Name/ID of snapshot :param bool strict: Raise an exception if multiple snapshot IDs are found :param str runas: The user that the prlctl command will be run as r �rR r" ) r$ r% r5 r6 r rK r r rY )r- rT rR r" r r r �_validate_snap_name, s r[ c C s� t jj�| �} |rt| ||d�}| g}|r|�d� |r#|�d|g� td||d�}|rTt|�}d� dd�}|D ]} t | | |d�}|d| � d t jj�|�� d �7 }q8|S |S ) ac List the snapshots :param str name: Name/ID of VM whose snapshots will be listed :param str snap_id: Name/ID of snapshot to display information about. If ``tree=True`` is also specified, display the snapshot subtree having this snapshot as the root snapshot :param bool tree: List snapshots in tree format rather than tabular format :param bool names: List snapshots as ID, name pairs :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.list_snapshots macvm runas=macdev salt '*' parallels.list_snapshots macvm tree=True runas=macdev salt '*' parallels.list_snapshots macvm snap_name=original runas=macdev salt '*' parallels.list_snapshots macvm names=True runas=macdev r! z--treerF rE z {:<38} {} z Snapshot IDz Snapshot Name�{z} � ) r$ r% r5 r6 r[ r r( r+ r rP rU ) r- rT Ztree�namesr" r �resrX �retrQ r r r �list_snapshotsE s" "ra c C sX t jj�| �} |rt jj�|�}| g}|r |�d|g� |r%|�d|g� td||d�S )a Create a snapshot :param str name: Name/ID of VM to take a snapshot of :param str snap_name: Name of snapshot :param str desc: Description of snapshot :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.create_snapshot macvm snap_name=macvm-original runas=macdev salt '*' parallels.create_snapshot macvm snap_name=macvm-updates desc='clean install with updates' runas=macdev r2 z --description�snapshotr! )r$ r% r5 r6 r( r+ )r- rT �descr" r r r r rb � s rb c C s� | }t jj�| �} t| |||d�}t|t�r|g}i }|D ]}|�d�}| d|g}td||d�||< q t |� � �} t | �dkrF|| d S |S )a� Delete a snapshot .. note:: Deleting a snapshot from which other snapshots are dervied will not delete the derived snapshots :param str name: Name/ID of VM whose snapshot will be deleted :param str snap_name: Name/ID of snapshot to delete :param str runas: The user that the prlctl command will be run as :param bool all: Delete all snapshots having the name given .. versionadded:: 2016.11.0 Example: .. code-block:: bash salt '*' parallels.delete_snapshot macvm 'unneeded snapshot' runas=macdev salt '*' parallels.delete_snapshot macvm 'Snapshot for linked clone' all=True runas=macdev rZ r rF zsnapshot-deleter! rV r ) r$ r% r5 r6 r[ r r r r+ r �keysrW ) r- rT r" r/ rR rX r` rQ r Zret_keysr r r �delete_snapshot� s re c C s4 t jj�| �} t| ||d�}| d|g}td||d�S )as Revert a VM to a snapshot :param str name: Name/ID of VM to revert to a snapshot :param str snap_name: Name/ID of snapshot to revert to :param str runas: The user that the prlctl command will be run as Example: .. code-block:: bash salt '*' parallels.revert_snapshot macvm base-with-updates runas=macdev r! rF zsnapshot-switch)r$ r% r5 r6 r[ r+ )r- rT r" r r r r �revert_snapshot� s rf )NN)NFFNNF)FFN)N)FN)TN)NFFN)NNN)NF)(�__doc__�loggingr r Zsalt.utils.datar$ Zsalt.utils.pathZsalt.utils.yamlZsalt.exceptionsr r Z__virtualname__Z__func_alias__� getLogger�__name__rL �compile�Ir r r r r+ r1 r3 r9 r= r> r@ rB rC rD r rU rY r[ ra rb re rf r r r r �<module> sH � � # ! 9 $ O ; > '9
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings