File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/win_shortcut.cpython-310.pyc
Back
o ;j�D � @ s� d Z ddlZddlZddlZddlZddlZddlZddlm Z dZ ej j � � r.ddlZdZ e�e�ZdZddd d d d d �Zdd� Zdd� Z ddd�Z ddd�Z ddd�ZdS )a Execution module for creating shortcuts on Windows. Handles file shortcuts (`.lnk`) and url shortcuts (`.url`). Allows for the configuration of icons and hot keys on file shortcuts. Changing the icon and hot keys are unsupported for url shortcuts. .. versionadded:: 3005 � N)�CommandExecutionErrorFT�shortcut�Normal� Maximized� Minimized� � � )r r r r r r c C s0 t jj�� s t�d� dS tst�d� dS tS )z$ Make sure we're on Windows �1Shortcut module only available on Windows systems)Fr � Shortcut module requires pywin32)Fr )�salt�utils�platform� is_windows�log�debug� HAS_WIN32�__virtualname__� r r �M/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/win_shortcut.py� __virtual__, s r c C s� t j�| �s td| � ���| �d�s!t j�| �\}}td|� ���tjj� � �� t j � d�}|� | �}d}d}d}d}d} d} d} tjj�|j�} | �d�r�|j} | r[tjj�| �} nd| � �} t�| � t| ��|jro|j}|jru|j}|jr{|j}|jr�|j�d �\}} |r�tjj�|�}|jr�t|j } |jr�tjj�|j�} n|j} |||t| �|| | | | d � W d � S 1 s�w Y d S ) a� Gets the properties for a shortcut Args: path (str): The path to the shortcut. Must have a `.lnk` or `.url` file extension. Returns: dict: A dictionary containing all available properties for the specified shortcut CLI Example: .. code-block:: bash salt '*' shortcut.get path='C:\path\to\shortcut.lnk' �Shortcut not found: ��.lnkz.url�Invalid file extension: � WScript.Shell� r r zNot a valid shortcut: �,) � arguments� description�hot_key� icon_index� icon_location�path�target� window_style� working_dirN) �osr# �existsr �endswith�splitextr r �winapi�Com�win32com�client�Dispatch�CreateShortcut�expandZFullName� TargetPathr r � Arguments� Description�Hotkey� IconLocation�split� WindowStyle� WINDOW_STYLE�WorkingDirectory�int)r# �_�ext�shellr r r r r" r! r% r& r$ �msgr r r �get; sh � ��$�r@ r c C s� t jj�| �} t jj�� �P tj�d�} | � | �} | � d�rN|r't jj�|�}|r,|| _ |r1|| _ |r6|| _ |rBd�|t|�g�| _|rIt| | _|rN|| _|| _| �� W d � dS 1 s`w Y dS )a The main worker function for creating and modifying shortcuts. the `create` and `modify` functions are wrappers around this function. Args: path (str): The full path to the shortcut. target (:obj:`str`, optional): The full path to the target. Defaults is "". arguments (:obj:`str`, optional): Any arguments to be passed to the target. Default is "". description (:obj:`str`, optional): The description for the shortcut. This is shown in the ``Comment`` field of the dialog box. Default is "". hot_key (:obj:`str`, optional): A combination of hot Keys to trigger this shortcut. This is something like ``Ctrl+Alt+D``. This is shown in the ``Shortcut key`` field in the dialog box. Available options are: - Ctrl - Alt - Shift - Ext Default is "". icon_index (:obj:`int`, optional): The index for the icon to use in files that contain multiple icons. Default is 0. icon_location (:obj`str`, optional): The full path to a file containing icons. This is shown in the ``Change Icon`` dialog box by clicking the ``Change Icon`` button. If no file is specified and a binary is passed as the target, Windows will attempt to get the icon from the binary file. Default is "". window_style (:obj:`str`, optional): The window style the program should start in. This is shown in the ``Run`` field of the dialog box. Valid options are: - Normal - Minimized - Maximized Default is "Normal". working_dir (:obj:`str`, optional): The full path to the working directory for the program to run in. This is shown in the ``Start in`` field of the dialog box. Default is "". Returns: bool: ``True`` if successful. r r r NT)r r r# r1 r+ r, r- r. r/ r0 r) r3 r4 r5 �join�strr6 r9 r8 r: r2 ZSave) r# r$ r r r r! r" r% r& r> r r r r � _set_info� s2 N ��rC c C s\ t j�| �s td| � ���| �d�s!t j�| �\} } td| � ���t| ||||||||d� S )a� Modify an existing shortcut. This can be a file shortcut (``.lnk``) or a url shortcut (``.url``). Args: path (str): The full path to the shortcut. Must have a `.lnk` or `.url` file extension. target (:obj:`str`, optional): The full path to the target. Default is "". arguments (:obj:`str`, optional): Any arguments to be passed to the target. Default is "". description (:obj:`str`, optional): The description for the shortcut. This is shown in the ``Comment`` field of the dialog box. Default is "". hot_key (:obj:`str`, optional): A combination of hot Keys to trigger this shortcut. This is something like ``Ctrl+Alt+D``. This is shown in the ``Shortcut key`` field in the dialog box. Available options are: - Ctrl - Alt - Shift - Ext Default is "". icon_index (:obj:`int`, optional): The index for the icon to use in files that contain multiple icons. Default is 0. icon_location (:obj:`str`, optional): The full path to a file containing icons. This is shown in the ``Change Icon`` dialog box by clicking the ``Change Icon`` button. If no file is specified and a binary is passed as the target, Windows will attempt to get the icon from the binary file. Default is "". window_style (:obj:`str`, optional): The window style the program should start in. This is shown in the ``Run`` field of the dialog box. Valid options are: - Normal - Minimized - Maximized Default is "Normal". working_dir (:obj:`str`, optional): The full path to the working directory for the program to run in. This is shown in the ``Start in`` field of the dialog box. Default is "". Returns: bool: ``True`` if successful. CLI Example: .. code-block:: bash # Modify an existing shortcut. Set it to target notepad.exe salt '*' shortcut.modify 'C:\path\to\shortcut.lnk' 'C:\Windows\notepad.exe' r r r � r# r r r r! r" r$ r% r& )r' r# r( r r) r* rC ) r# r$ r r r r! r" r% r& r< r= r r r �modify� s V �rE c C sd | � d�stj�| �\} }td|� ���tj�| �rZ| rBt�d| � tj�| �\}}|�d�}|� dt � � � d|� �}t� | |� n| rPt�d| � t� | � n t�d| � td��tj� tj�| ��s�| r�| sltd } td | �s{td � } | s{d } z td | | d� W n ty� } ztd|j� ���d}~ww tdtj�| �� ���t| ||||||||d� S )aC Create a new shortcut. This can be a file shortcut (``.lnk``) or a url shortcut (``.url``). Args: path (str): The full path to the shortcut. Must have a `.lnk` or `.url` file extension. target (str): The full path to the target. arguments (:obj:`str`, optional): Any arguments to be passed to the target. Default is "". description (:obj:`str`, optional): The description for the shortcut. This is shown in the ``Comment`` field of the dialog box. Default is "". hot_key (:obj:`str`, optional): A combination of hot Keys to trigger this shortcut. This is something like ``Ctrl+Alt+D``. This is shown in the ``Shortcut key`` field in the dialog box. Available options are: - Ctrl - Alt - Shift - Ext Default is "". icon_index (:obj:`int`, optional): The index for the icon to use in files that contain multiple icons. Default is 0. icon_location (:obj:`str`, optional): The full path to a file containing icons. This is shown in the ``Change Icon`` dialog box by clicking the ``Change Icon`` button. If no file is specified and a binary is passed as the target, Windows will attempt to get the icon from the binary file. Default is "". window_style (:obj:`str`, optional): The window style the program should start in. This is shown in the ``Run`` field of the dialog box. Valid options are: - Normal - Minimized - Maximized Default is "Normal". working_dir (:obj:`str`, optional): The full path to the working directory for the program to run in. This is shown in the ``Start in`` field of the dialog box. Default is "". backup (:obj:`bool`, optional): If there is already a shortcut with the same name, set this value to ``True`` to backup the existing shortcut and continue creating the new shortcut. Default is ``False``. force (:obj:`bool`, optional): If there is already a shortcut with the same name and you aren't backing up the shortcut, set this value to ``True`` to remove the existing shortcut and create a new with these settings. Default is ``False``. make_dirs (:obj:`bool`, optional): If the parent directory structure does not exist for the new shortcut, create it. Default is ``False``. user (:obj:`str`, optional): The user to be the owner of any directories created by setting ``make_dirs`` to ``True``. If no value is passed, Salt will use the user account that it is running under. Default is "". Returns: bool: ``True`` if successful. Raises: CommandExecutionError: If the path is not a ``.lnk`` or ``.url`` file extension. CommandExecutionError: If there is an existing shortcut with the same name and ``backup`` and ``force`` are both ``False`` CommandExecutionError: If the parent directory is not created and ``make_dirs`` is ``False`` CommandExecutionError: If there was an error creating the parent directories CLI Example: .. code-block:: bash # Create a shortcut and set the ``Shortcut key`` (``hot_key``) salt '*' shortcut.create 'C:\path\to\shortcut.lnk' 'C:\Windows\notepad.exe' hot_key='Ctrl+Alt+N' # Create a shortcut and change the icon to the 3rd one in the icon file salt '*' shortcut.create 'C:\path\to\shortcut.lnk' 'C:\Windows\notepad.exe' icon_location='C:\path\to\icon.ico' icon_index=2 # Create a shortcut and change the startup mode to full screen salt '*' shortcut.create 'C:\path\to\shortcut.lnk' 'C:\Windows\notepad.exe' window_style='Maximized' # Create a shortcut and change the icon salt '*' shortcut.create 'C:\path\to\shortcut.lnk' 'C:\Windows\notepad.exe' icon_location='C:\path\to\icon.ico' # Create a shortcut and force it to overwrite an existing shortcut salt '*' shortcut.create 'C:\path\to\shortcut.lnk' 'C:\Windows\notepad.exe' force=True # Create a shortcut and create any parent directories if they are missing salt '*' shortcut.create 'C:\path\to\shortcut.lnk' 'C:\Windows\notepad.exe' make_dirs=True r r zBacking up: %s�.�-z Removing: %szShortcut exists: %szFound existing shortcut�userz user.infoz user.currentZSYSTEMz file.makedirs)r# �ownerz!Error creating parent directory: Nz Parent directory not present: rD )r) r' r# r* r r( r r �strip�time�time_ns�rename�remove�isdir�dirnameZ__opts__Z__salt__�messagerC )r# r$ r r r r! r" r% r& Zbackup�forceZ make_dirsrH r< r= �fileZ backup_path�excr r r �createh s\ �����rU )r r r r r r r r ) r r r r r r r FFFN)�__doc__�loggingr' rK Zsalt.utils.pathr Zsalt.utils.platformZsalt.utils.winapiZsalt.exceptionsr r r r r Zwin32com.clientr- � getLogger�__name__r r r9 r r@ rC rE rU r r r r �<module> sj � U �r �m�
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings