community.general.gio_mime 模块 – 为使用 Gnome GIO 的应用程序设置 MIME 类型的默认处理程序

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包,您可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install community.general

要在 playbook 中使用它,请指定:community.general.gio_mime

community.general 7.5.0 中的新增功能

概要

  • 此模块允许配置特定 MIME 类型的默认处理程序,供使用 Gnome GIO API 构建的应用程序使用。

参数

参数

注释

handler

字符串 / 必需

将为 MIME 类型设置默认处理程序。

mime_type

字符串 / 必需

将为其设置默认处理程序的 MIME 类型。

属性

属性

支持

描述

check_mode

支持: 完全

可以在 check_mode 中运行,并返回更改状态预测,而无需修改目标。

diff_mode

支持: 完全

当处于差异模式时,将返回已更改(或可能需要在 check_mode 中更改)的详细信息。

备注

注意

  • 此模块是 gio mime 命令(和子命令)的精简包装器。

  • 有关更多详细信息,请参阅 man gio(1)。

另请参阅

另请参阅

C(gio) 命令手册页

命令的手册页。

GIO 文档

GIO API 的参考文档。

示例

---
- name: Set chrome as the default handler for https
  community.general.gio_mime:
    mime_type: x-scheme-handler/https
    handler: google-chrome.desktop
  register: result

返回值

常见的返回值记录在此处,以下是此模块特有的字段

描述

handler

字符串

设置为默认的处理程序。

返回: 成功

示例: "google-chrome.desktop"

stderr

字符串

gio 命令的错误输出。

返回: 失败

示例: "gio: Failed to load info for handler \"never-existed.desktop\""

stdout

字符串

gio 命令的输出。

返回: 成功

示例: "Set google-chrome.desktop as the default for x-scheme-handler/https"

version

字符串

在 community.general 10.0.0 中添加

gio 的版本。

返回: 始终

示例: "2.80.0"

作者

  • Alexei Znamensky (@russoz)