Current File : //lib/python2.7/site-packages/salt/modules/parallels.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l
Z d d l Z d d l m
Z
m Z d d l m Z d Z i d d 6Z e j e � Z e j d e j � Z d
� Z d � Z d d d � Z d d d
� Z d e e d d e d � Z e e d d � Z d d � Z! d d � Z" d d � Z# e d d � Z$ d d � Z% d d � Z& d d � Z' d d � Z( e d d � Z) e d d � Z* e+ d d � Z, d e e d d � Z- d d d d � Z. d e d � Z/ d d � Z0 d S( u�
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
i ( t absolute_importt print_functiont unicode_literalsN( t SaltInvocationErrort CommandExecutionError( t sixu parallelsu execu exec_uB {?([0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12})}?c C@ sh t | t j � r t j | � St | t t f � rT g | D] } t j | � ^ q; St j | � g Sd S( u*
Return args as a list of strings
N( t
isinstanceR t string_typest shlext splitt tuplet listt text_type( t argst arg( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt _normalize_args1 s
c C@ sg g } xH t j t | � D]4 } | j � r | j | j d � j d � � q q Wt t t | � � � S( u�
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}
i u {}(
t ret finditert
GUID_REGEXt groupst appendt groupt stript sortedR t set( t guid_stringt guidst
found_guid( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt _find_guids> s
&c C@ s` t j j j d � s$ t d � � n d | g } | rL | j t | � � n t d | d | �S( u
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
u prlsrvctlu prlsrvctl utility not availableu cmd.runt runas( t saltt utilst patht whichR t extendR t __salt__( t sub_cmdR
R t cmd( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt prlsrvctlS s c C@ s` t j j j d � s$ t d � � n d | g } | rL | j t | � � n t d | d | �S( u�
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
u prlctlu prlctl utility not availableu cmd.runR ( R R R R! R R" R R# ( R$ R
R R% ( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt prlctlv s c C@ s� | d k r g } n t | � } | r: | j | g � n | rP | j d � n | rf | j d � n | r| | j d � n t d | d | �S( u�
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
u --infou --allu
--templateu listR N( t NoneR R" R R' ( t namet infot allR
R t template( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt list_vms� s ' c C@ sl t j j j | � d t j j j | � g } | rC | j d � n | rY | j d � n t d | d | �S( uM
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
u --nameu --linkedu
--templateu cloneR ( R R t datat decodeR R' ( R) t new_namet linkedR, R R
( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt clone� s -c C@ s" t d t j j j | � d | �S( u*
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
u deleteR ( R' R R R. R/ ( R) R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt delete� s c C@ sL t | d t d | �j � } x' | D] } d j | � | k r% t Sq% Wt S( u
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
R* R u Name: {0}( R- t Truet
splitlinest formatt False( R) R t vm_infot info_line( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt exists s
c C@ s" t d t j j j | � d | �S( u�
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
u startR ( R' R R R. R/ ( R) R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt start" s c C@ sA t j j j | � g } | r. | j d � n t d | d | �S( uf
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
u --killu stopR ( R R R. R/ R R' ( R) t killR R
( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt stop5 s c C@ s" t d t j j j | � d | �S( u5
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
u restartR ( R' R R R. R/ ( R) R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt restartR s c C@ s" t d t j j j | � d | �S( u&
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
u resetR ( R' R R R. R/ ( R) R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt resetf s c C@ s" t d t j j j | � d | �S( u
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
u statusR ( R' R R R. R/ ( R) R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt statusy s c C@ s> t j j j | � g } | j t | � � t d | d | �S( u`
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
u execR ( R R R. R/ R" R R' ( R) t commandR R
( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt exec_� s c C@ sk t j j j | � } t j t | � sN t d j t j j j | � � � � n t d | d | g d | �} t
| � s� t d j | | � � � n y t j j j | � } Wn2 t j j j
k
r� } t j d | � i } n Xt | t � r| j d d � } | d k r0d } q0n t j d | � d } | rX| rXt d
j | | � � � n t j j j | � S( uY
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
u Snapshot ID "{0}" is not a GUIDu
snapshot-listu --idR u' No snapshots for VM "{0}" have ID "{1}"u: Could not interpret snapshot data returned from prlctl: %su Nameu u^ Could not interpret snapshot data returned from prlctl: data is not formed as a dictionary: %su@ Could not find a snapshot name for snapshot ID "{0}" of VM "{1}"N( R R R. R/ R t matchR R R6 R' t lent yamlt safe_loadt YAMLErrort logt warningR t dictt getR( ( R) t snap_idt strictR R* R. t errt snap_name( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt snapshot_id_to_name� s6 #$
c C@ s t j j j | � } t j j j | � } t d | d | �} t | � } g } x9 | D]1 } t | | d | �| k rX | j | � qX qX Wt | � d k r� t d j
| | � � � nR t | � d k r� | d Sd j
| | � } | r� t | � � n
t j | � | Sd S( ua
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
u
snapshot-listR i u) No snapshots for VM "{0}" have name "{1}"i u/ Multiple snapshots for VM "{0}" have name "{1}"N(
R R R. R/ R' R RP R RD R R6 RH RI ( R) RO RM R R* t snap_idst named_idsRL t multi_msg( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt snapshot_name_to_id� s&
c C@ sQ t j j j | � } t j t | � r4 | j d � St | | d | d | �Sd S( uk
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
u {}RM R N( R R R. R/ R RC R R RT ( R) RO RM R ( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt _validate_snap_name2 s
c
C@ s� t j j j | � } | r3 t | | d | �} n | g } | rR | j d � n | rn | j d | g � n t d | d | �} | r� t | � } d j d d � } xH | D]@ } t
| | d | �} | d j | t j j j | � � 7} q� W| S| Sd S(
uc
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 u --treeu --idu
snapshot-listu
{0:<38} {1}
u Snapshot IDu
Snapshot Nameu
{{{0}}} {1}
N( R R R. R/ RU R R" R' R R6 RP (
R) RO t treet namesR R
t resRQ t retRL ( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt list_snapshotsK s"
)c C@ s� t j j j | � } | r3 t j j j | � } n | g } | rX | j d | g � n | rt | j d | g � n t d | d | �S( u
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
u --nameu
--descriptionu snapshotR ( R R R. R/ R" R' ( R) RO t descR R
( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt snapshot� s c
C@ s� | } t j j j | � } t | | d | d | �} t | t j � rU | g } n i } xE | D]= } | j d � } | d | g } t d | d | �| | <qb Wt
| j � � } t | � d k r� | | d S| Sd S( u�
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
RM R u {}u --idu snapshot-deletei i N(
R R R. R/ RU R R R R R' R t keysRD (
R) RO R R+ RM RQ RY RL R
t ret_keys( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt delete_snapshot� s
c C@ sL t j j j | � } t | | d | �} | d | g } t d | d | �S( us
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 u --idu snapshot-switch( R R R. R/ RU R' ( R) RO R R
( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt revert_snapshot� s (1 t __doc__t
__future__R R R R t loggingR t salt.utils.dataR t salt.utils.patht salt.utils.yamlt salt.exceptionsR R t salt.extR t __virtualname__t __func_alias__t getLoggert __name__RH t compilet IR R R R( R& R' R7 R- R2 R3 R: R; R= R> R? R@ RB RP RT R4 RU RZ R\ R_ R` ( ( ( s: /usr/lib/python2.7/site-packages/salt/modules/parallels.pyt <module> sF
#!9$ Q:>'9
Mini Shell