File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/states/__pycache__/win_shortcut.cpython-310.pyc
Back
o ;j � @ sZ d Z ddlZddlZddlZddlmZ dZdd� Z d d d �Z dS ) a State 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)�CommandExecutionErrorZshortcutc C s$ t jj�� sdS t�dd�sdS tS )z' Only works on Windows systems )Fz1Shortcut state only available on Windows systems.�shortcut.createN)Fz,Shortcut state requires the shortcut module.)�salt�utils�platformZ is_windows�__salt__�get�__virtualname__� r r �L/opt/saltstack/salt/lib/python3.10/site-packages/salt/states/win_shortcut.py� __virtual__ s r � �NormalFc C s | i dg d�} |||t jj�|�|t jj�| �t jj�|�|t jj�|�d� }ztd | �}t jj�||�}|s?d| d< | W S W n tyK i }Y nw td rk|r^d| � �| d< || d < nd | � �| d< d | d < | S ztd |||||| |||| | | | d� W n( ty� } z d| � �g| d< | d � |j � d| d < | W Y d }~S d }~ww ztd | �}W n( ty� } z d| � �g| d< | d � |j � d| d < | W Y d }~S d }~ww t jj�||�}|r�d| d< || d d< d| d < | S |�rd| � �| d< || d < | S d| � �| d< | S )ar Create a new shortcut. This can be a file shortcut (``.lnk``) or a url shortcut (``.url``). Args: name (str): The full path to the shortcut target (str): The full path to the target arguments (str, optional): Any arguments to be passed to the target description (str, optional): The description for the shortcut. This is shown in the ``Comment`` field of the dialog box. Default is an empty string hot_key (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. Default is an empty string. Available options are: - Ctrl - Alt - Shift - Ext icon_index (int, optional): The index for the icon to use in files that contain multiple icons. Default is 0 icon_location (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 an empty string window_style (str, optional): The window style the program should start in. This is shown in the ``Run`` field of the dialog box. Default is ``Normal``. Valid options are: - Normal - Minimized - Maximized working_dir (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. backup (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 (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 (bool, optional): If the parent directory structure does not exist for the new shortcut, create it. Default is ``False`` user (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 an empty string. Returns: dict: A dictionary containing the changes, comments, and result of the state Example: .. code-block:: yaml KB123456: wusa.installed: - source: salt://kb123456.msu # Create a shortcut and set the ``Shortcut key`` (``hot_key``) new_shortcut: shortcut.present: - name: C:\path\to\shortcut.lnk - target: C:\Windows\notepad.exe - hot_key: Ctrl+Alt+N # Create a shortcut and change the icon to the 3rd one in the icon file new_shortcut: shortcut.present: - name: C:\path\to\shortcut.lnk - target: 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 new_shortcut: shortcut.present: - name: C:\path\to\shortcut.lnk - target: C:\Windows\notepad.exe - window_style: Maximized # Create a shortcut and change the icon new_shortcut: shortcut.present: - name: C:\path\to\shortcut.lnk - target: C:\Windows\notepad.exe - icon_location: C:\path\to\icon.ico # Create a shortcut and force it to overwrite an existing shortcut new_shortcut: shortcut.present: - name: C:\path\to\shortcut.lnk - target: C:\Windows\notepad.exe - force: True # Create a shortcut and create any parent directories if they are missing new_shortcut: shortcut.present: - name: C:\path\to\shortcut.lnk - target: C:\Windows\notepad.exe - make_dirs: True T)�name�changes�result�comment) � arguments� description�hot_key� icon_location� icon_index�path�target� window_style� working_dirz shortcut.getz'Shortcut already present and configuredr �testzShortcut will be modified: r zShortcut will be created: Nr r ) r r r r r r r r r �backup�force� make_dirs�userz Failed to create the shortcut: Fz%Failed to make the following changes:ZfailedzShortcut modified: zShortcut created: ) r r r �expandr �dataZ compare_dictsr Z__opts__�append�message)r r r r r r r r r r r r r �retZproposed�oldr �exc�newZverify_changesr r r �present s� � � � ����� �r) ) r r r r r r r r FFFN) �__doc__Zsalt.utils.datar Zsalt.utils.pathZsalt.utils.platformZsalt.exceptionsr r r r) r r r r �<module> s( �
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings