Модуль community.general.xdg_mime — установка обработчика по умолчанию для типов MIME в приложениях, использующих инструменты XDG

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.xdg_mime.

Добавлено в community.general 10.7.0

Краткое описание
Параметры
Атрибуты
Примечания
См. также
Примеры
Возвращаемые значения

Краткое описание

Этот модуль позволяет настроить обработчик по умолчанию для определённых типов MIME при использовании приложений, опирающихся на XDG.

Параметры

Параметр	Комментарии
handler строка / обязательный	Устанавливает обработчик по умолчанию для указанных типов MIME. Файл рабочего стола должен быть установлен в системе. Если файл рабочего стола не установлен, модуль не завершится с ошибкой, но обработчик также не будет установлен. Необходимо передать обработчик в формате `*.desktop`, иначе модуль завершится с ошибкой.
mime_types список / элементы=строка / обязательный	Один или несколько типов MIME, для которых устанавливается обработчик по умолчанию.

Параметр

Комментарии

handler

строка / обязательный

Устанавливает обработчик по умолчанию для указанных типов MIME.

Файл рабочего стола должен быть установлен в системе. Если файл рабочего стола не установлен, модуль не завершится с ошибкой, но обработчик также не будет установлен.

Необходимо передать обработчик в формате *.desktop, иначе модуль завершится с ошибкой.

mime_types

список / элементы=строка / обязательный

Один или несколько типов MIME, для которых устанавливается обработчик по умолчанию.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогнозируемый статус изменений, не изменяя целевую систему.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает сведения о том, что изменилось (или, возможно, требует изменения в `check_mode`).

Примечания

Примечание

Этот модуль представляет собой тонкую обёртку над инструментом xdg-mime.
Дополнительные сведения см. на странице справки man xdg-mime(1).

См. также

Справочная страница команды C(xdg-mime): Справочная страница команды.
Документация xdg-utils: Справочная документация по xdg-utils.

Примеры

- name: Set Chrome as the default handler for HTTPS
  community.general.xdg_mime:
    mime_types: x-scheme-handler/https
    handler: google-chrome.desktop
  register: result

- name: Set Chrome as the default handler for both HTTP and HTTPS
  community.general.xdg_mime:
    mime_types:
      - x-scheme-handler/http
      - x-scheme-handler/https
    handler: google-chrome.desktop
  register: result

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
current_handlers список / элементы=строка	Текущие обработчики для переданных типов MIME. Возвращается: при успехе Пример: `["google-chrome.desktop", "firefox.desktop"]`
version строка	Версия инструмента `xdg-mime`. Возвращается: всегда Пример: `"1.2.1"`

Авторы

Marcos Alano (@mhalano)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/xdg_mime_module.html