一、python-dbusx 包概述python-dbusx是一个基于 libdbus 的轻量级 Python D-Bus 绑定库核心优势是原生支持事件驱动 I/O无需依赖 GLib 主循环适合高并发、异步化的 Linux 系统 IPC 场景。核心定位替代传统 dbus-python专注事件驱动无额外依赖仅依赖 libdbus。维护状态Beta 版0.92013 年发布兼容 Python 2.6/2.7、3.2/3.3。许可证MIT。核心特性事件驱动 I/O支持自定义事件循环如 libev、libuv。原生异步调用无 GIL 阻塞。简洁 API无类型自动推断显式类型安全。支持会话总线SessionBus、系统总线SystemBus。二、安装指南1. 系统依赖Linux# Debian/Ubuntusudoaptinstalllibdbus-1-dev# CentOS/RHELsudoyuminstalldbus-devel2. pip 安装推荐# 稳定版 0.9pipinstallpython-dbusx# 或从源码安装gitclone https://github.com/geertj/python-dbusx.gitcdpython-dbusx python setup.py buildsudopython setup.pyinstall3. 验证安装importdbusxprint(dbusx.__version__)# 输出 0.9三、核心语法与参数详解1. 核心模块与类dbusx.Bus总线基类SessionBus/SystemBus 的父类。dbusx.SessionBus会话总线用户级服务如桌面通知。dbusx.SystemBus系统总线系统级服务如 NetworkManager、systemd。dbusx.ProxyObject远程对象代理用于调用 D-Bus 方法、监听信号。dbusx.InterfaceD-Bus 接口封装定义方法/信号/属性。2. 基础连接语法importdbusx# 1. 连接会话总线用户服务session_busdbusx.SessionBus()# 2. 连接系统总线系统服务system_busdbusx.SystemBus()3. 代理对象调用方法调用语法bus.get_object(service_name, object_path)service_nameD-Bus 服务名如org.freedesktop.NetworkManager。object_path对象路径如/org/freedesktop/NetworkManager。# 示例调用 NetworkManager 获取版本nmsystem_bus.get_object(service_nameorg.freedesktop.NetworkManager,object_path/org/freedesktop/NetworkManager)# 调用方法显式类型s字符串u无符号整型versionnm.Get(org.freedesktop.NetworkManager,Version,signatures)print(version)4. 信号监听语法语法bus.add_signal_listener(interface, signal_name, callback)interface信号所属接口。signal_name信号名。callback回调函数接收信号参数。# 监听系统睡眠信号defon_sleep(state):print(f系统睡眠状态{state})system_bus.add_signal_listener(interfaceorg.freedesktop.login1.Manager,signal_namePrepareForSleep,callbackon_sleep)5. 事件循环集成核心特性python-dbusx 支持 PEP 3156 兼容事件循环如 looping 库。fromloopingimportevloop# 绑定 libev 事件循环busdbusx.SessionBus(loopevloop.LibevLoop())# 启动事件循环bus.loop.run()6. 类型映射显式类型无自动推断D-Bus 类型标识Python 类型字符串sstr整型iint无符号整型uint布尔bbool浮点dfloat对象路径ostr数组alist四、8 个实际应用案例案例 1系统总线获取 NetworkManager 状态场景监控网络连接状态自动切换备用网络。importdbusx busdbusx.SystemBus()nmbus.get_object(org.freedesktop.NetworkManager,/org/freedesktop/NetworkManager)# 获取网络状态70已连接20断开statenm.Get(org.freedesktop.NetworkManager,State,signatureu)print(f网络状态码{state})案例 2会话总线发送桌面通知场景Linux 桌面应用推送消息如邮件提醒、任务通知。importdbusx busdbusx.SessionBus()notifybus.get_object(org.freedesktop.Notifications,/org/freedesktop/Notifications)# 发送通知app名、id、图标、标题、内容、动作、提示、超时notify.Notify(MyApp,0,dialog-info,提醒,您有新消息,[],{},5000,signaturesusssasa{sv}i)案例 3监听系统睡眠/唤醒信号场景笔记本休眠前保存数据唤醒后恢复服务。importdbusxdefon_prepare_sleep(state):ifstate:print(系统即将休眠保存数据...)else:print(系统唤醒恢复服务...)busdbusx.SystemBus()bus.add_signal_listener(org.freedesktop.login1.Manager,PrepareForSleep,on_prepare_sleep)bus.loop.run()案例 4控制 systemd 服务启停场景自动化运维远程管理系统服务如 Nginx、MySQL。importdbusx busdbusx.SystemBus()systemdbus.get_object(org.freedesktop.systemd1,/org/freedesktop/systemd1)# 启动 Nginx 服务systemd.StartUnit(nginx.service,replace,signaturess)# 停止 Nginx 服务systemd.StopUnit(nginx.service,replace,signaturess)案例 5异步调用 D-Bus 方法事件驱动场景高并发场景非阻塞调用多个 D-Bus 服务。importdbusxfromloopingimportevloopdefon_result(result):print(f异步结果{result})busdbusx.SessionBus(loopevloop.LibevLoop())notifybus.get_object(org.freedesktop.Notifications,/org/freedesktop/Notifications)# 异步调用非阻塞notify.NotifyAsync(AsyncApp,0,dialog-info,异步通知,事件驱动调用成功,[],{},3000,signaturesusssasa{sv}i,callbackon_result)bus.loop.run()案例 6获取蓝牙设备列表BlueZ场景蓝牙设备管理扫描并连接蓝牙外设。importdbusx busdbusx.SystemBus()bluezbus.get_object(org.bluez,/)# 扫描蓝牙设备devicesbluez.GetManagedObjects(signature)forpath,propsindevices.items():iforg.bluez.Device1inprops:print(f蓝牙设备{path}名称{props[org.bluez.Device1][Name]})案例 7监控系统电源状态场景电量低于阈值时自动关机或提醒。importdbusxdefon_battery_update(percentage):print(f电量{percentage}%)ifpercentage20:print(电量过低准备关机...)busdbusx.SystemBus()bus.add_signal_listener(org.freedesktop.UPower.Device,PropertiesChanged,on_battery_update)bus.loop.run()案例 8自定义 D-Bus 服务服务端场景进程间通信Python 服务暴露接口供其他程序调用。importdbusx# 1. 创建自定义接口classMyService(dbusx.Interface):interface_nameorg.example.MyServicedbusx.method(out_signatures)defHello(self):returnHello from python-dbusx!# 2. 注册服务到会话总线busdbusx.SessionBus()bus.register_service(org.example.MyService)bus.export_object(/org/example/MyService,MyService())# 3. 启动服务bus.loop.run()五、常见错误与解决方案1. 连接失败Failed to connect to system bus原因libdbus 未安装、D-Bus 服务未启动、权限不足。解决# 安装依赖sudoaptinstalllibdbus-1-dev# 启动 D-Bus 服务sudosystemctl start dbus# 权限问题用 root 或加入 dbus 组sudousermod-aGdbus$USER2. 无信号回调Signal listener not triggered原因接口/信号名错误、总线类型不匹配系统/会话、事件循环未启动。解决用dbus-monitor工具验证信号dbus-monitor | grep 信号名。确认总线类型系统总线用 SystemBus会话用 SessionBus。启动事件循环bus.loop.run()。3. 类型错误Invalid signature原因方法调用时参数类型与 D-Bus 接口不匹配。解决严格匹配类型标识s字符串、i整型等参考接口文档。4. 服务不存在Service not found原因服务名错误、服务未运行、对象路径错误。解决查看运行中的服务qdbus | grep 服务名。核对服务名和对象路径如 NetworkManager 的路径固定。5. 事件循环阻塞Loop not responding原因回调函数执行耗时操作阻塞事件循环。解决耗时操作放入线程池回调仅处理结果。六、使用注意事项Python 版本限制仅支持 Python 2.6/2.7、3.2/3.3不支持 3.4新项目优先考虑 python-sdbus 或 dasbus。事件循环必启所有信号监听、异步调用必须启动事件循环bus.loop.run()否则无响应。显式类型安全无自动类型转换参数类型必须严格匹配避免隐式错误。总线权限隔离系统总线SystemBus需 root 或特殊权限会话总线SessionBus仅当前用户可用。资源释放长时间运行的服务需在退出时释放总线连接避免文件描述符泄漏。替代库选择python-dbusx 已长期未更新新项目推荐python-sdbus现代异步支持 asyncio。dasbus简洁 API兼容 Python 3。pydbusPythonic 风格易用性高。总结python-dbusx 是轻量级、事件驱动的 D-Bus 库适合老旧 Python 版本、高并发 IPC 场景。核心优势是无 GLib 依赖、原生异步但需注意版本限制和显式类型要求。新项目建议优先选择现代替代库老旧系统维护可继续使用 python-dbusx。《动手学PyTorch建模与应用:从深度学习到大模型》是一本从零基础上手深度学习和大模型的PyTorch实战指南。全书共11章前6章涵盖深度学习基础包括张量运算、神经网络原理、数据预处理及卷积神经网络等后5章进阶探讨图像、文本、音频建模技术并结合Transformer架构解析大语言模型的开发实践。书中通过房价预测、图像分类等案例讲解模型构建方法每章附有动手练习题帮助读者巩固实战能力。内容兼顾数学原理与工程实现适配PyTorch框架最新技术发展趋势。
Python之python-dbusx包语法、参数和实际应用案例
一、python-dbusx 包概述python-dbusx是一个基于 libdbus 的轻量级 Python D-Bus 绑定库核心优势是原生支持事件驱动 I/O无需依赖 GLib 主循环适合高并发、异步化的 Linux 系统 IPC 场景。核心定位替代传统 dbus-python专注事件驱动无额外依赖仅依赖 libdbus。维护状态Beta 版0.92013 年发布兼容 Python 2.6/2.7、3.2/3.3。许可证MIT。核心特性事件驱动 I/O支持自定义事件循环如 libev、libuv。原生异步调用无 GIL 阻塞。简洁 API无类型自动推断显式类型安全。支持会话总线SessionBus、系统总线SystemBus。二、安装指南1. 系统依赖Linux# Debian/Ubuntusudoaptinstalllibdbus-1-dev# CentOS/RHELsudoyuminstalldbus-devel2. pip 安装推荐# 稳定版 0.9pipinstallpython-dbusx# 或从源码安装gitclone https://github.com/geertj/python-dbusx.gitcdpython-dbusx python setup.py buildsudopython setup.pyinstall3. 验证安装importdbusxprint(dbusx.__version__)# 输出 0.9三、核心语法与参数详解1. 核心模块与类dbusx.Bus总线基类SessionBus/SystemBus 的父类。dbusx.SessionBus会话总线用户级服务如桌面通知。dbusx.SystemBus系统总线系统级服务如 NetworkManager、systemd。dbusx.ProxyObject远程对象代理用于调用 D-Bus 方法、监听信号。dbusx.InterfaceD-Bus 接口封装定义方法/信号/属性。2. 基础连接语法importdbusx# 1. 连接会话总线用户服务session_busdbusx.SessionBus()# 2. 连接系统总线系统服务system_busdbusx.SystemBus()3. 代理对象调用方法调用语法bus.get_object(service_name, object_path)service_nameD-Bus 服务名如org.freedesktop.NetworkManager。object_path对象路径如/org/freedesktop/NetworkManager。# 示例调用 NetworkManager 获取版本nmsystem_bus.get_object(service_nameorg.freedesktop.NetworkManager,object_path/org/freedesktop/NetworkManager)# 调用方法显式类型s字符串u无符号整型versionnm.Get(org.freedesktop.NetworkManager,Version,signatures)print(version)4. 信号监听语法语法bus.add_signal_listener(interface, signal_name, callback)interface信号所属接口。signal_name信号名。callback回调函数接收信号参数。# 监听系统睡眠信号defon_sleep(state):print(f系统睡眠状态{state})system_bus.add_signal_listener(interfaceorg.freedesktop.login1.Manager,signal_namePrepareForSleep,callbackon_sleep)5. 事件循环集成核心特性python-dbusx 支持 PEP 3156 兼容事件循环如 looping 库。fromloopingimportevloop# 绑定 libev 事件循环busdbusx.SessionBus(loopevloop.LibevLoop())# 启动事件循环bus.loop.run()6. 类型映射显式类型无自动推断D-Bus 类型标识Python 类型字符串sstr整型iint无符号整型uint布尔bbool浮点dfloat对象路径ostr数组alist四、8 个实际应用案例案例 1系统总线获取 NetworkManager 状态场景监控网络连接状态自动切换备用网络。importdbusx busdbusx.SystemBus()nmbus.get_object(org.freedesktop.NetworkManager,/org/freedesktop/NetworkManager)# 获取网络状态70已连接20断开statenm.Get(org.freedesktop.NetworkManager,State,signatureu)print(f网络状态码{state})案例 2会话总线发送桌面通知场景Linux 桌面应用推送消息如邮件提醒、任务通知。importdbusx busdbusx.SessionBus()notifybus.get_object(org.freedesktop.Notifications,/org/freedesktop/Notifications)# 发送通知app名、id、图标、标题、内容、动作、提示、超时notify.Notify(MyApp,0,dialog-info,提醒,您有新消息,[],{},5000,signaturesusssasa{sv}i)案例 3监听系统睡眠/唤醒信号场景笔记本休眠前保存数据唤醒后恢复服务。importdbusxdefon_prepare_sleep(state):ifstate:print(系统即将休眠保存数据...)else:print(系统唤醒恢复服务...)busdbusx.SystemBus()bus.add_signal_listener(org.freedesktop.login1.Manager,PrepareForSleep,on_prepare_sleep)bus.loop.run()案例 4控制 systemd 服务启停场景自动化运维远程管理系统服务如 Nginx、MySQL。importdbusx busdbusx.SystemBus()systemdbus.get_object(org.freedesktop.systemd1,/org/freedesktop/systemd1)# 启动 Nginx 服务systemd.StartUnit(nginx.service,replace,signaturess)# 停止 Nginx 服务systemd.StopUnit(nginx.service,replace,signaturess)案例 5异步调用 D-Bus 方法事件驱动场景高并发场景非阻塞调用多个 D-Bus 服务。importdbusxfromloopingimportevloopdefon_result(result):print(f异步结果{result})busdbusx.SessionBus(loopevloop.LibevLoop())notifybus.get_object(org.freedesktop.Notifications,/org/freedesktop/Notifications)# 异步调用非阻塞notify.NotifyAsync(AsyncApp,0,dialog-info,异步通知,事件驱动调用成功,[],{},3000,signaturesusssasa{sv}i,callbackon_result)bus.loop.run()案例 6获取蓝牙设备列表BlueZ场景蓝牙设备管理扫描并连接蓝牙外设。importdbusx busdbusx.SystemBus()bluezbus.get_object(org.bluez,/)# 扫描蓝牙设备devicesbluez.GetManagedObjects(signature)forpath,propsindevices.items():iforg.bluez.Device1inprops:print(f蓝牙设备{path}名称{props[org.bluez.Device1][Name]})案例 7监控系统电源状态场景电量低于阈值时自动关机或提醒。importdbusxdefon_battery_update(percentage):print(f电量{percentage}%)ifpercentage20:print(电量过低准备关机...)busdbusx.SystemBus()bus.add_signal_listener(org.freedesktop.UPower.Device,PropertiesChanged,on_battery_update)bus.loop.run()案例 8自定义 D-Bus 服务服务端场景进程间通信Python 服务暴露接口供其他程序调用。importdbusx# 1. 创建自定义接口classMyService(dbusx.Interface):interface_nameorg.example.MyServicedbusx.method(out_signatures)defHello(self):returnHello from python-dbusx!# 2. 注册服务到会话总线busdbusx.SessionBus()bus.register_service(org.example.MyService)bus.export_object(/org/example/MyService,MyService())# 3. 启动服务bus.loop.run()五、常见错误与解决方案1. 连接失败Failed to connect to system bus原因libdbus 未安装、D-Bus 服务未启动、权限不足。解决# 安装依赖sudoaptinstalllibdbus-1-dev# 启动 D-Bus 服务sudosystemctl start dbus# 权限问题用 root 或加入 dbus 组sudousermod-aGdbus$USER2. 无信号回调Signal listener not triggered原因接口/信号名错误、总线类型不匹配系统/会话、事件循环未启动。解决用dbus-monitor工具验证信号dbus-monitor | grep 信号名。确认总线类型系统总线用 SystemBus会话用 SessionBus。启动事件循环bus.loop.run()。3. 类型错误Invalid signature原因方法调用时参数类型与 D-Bus 接口不匹配。解决严格匹配类型标识s字符串、i整型等参考接口文档。4. 服务不存在Service not found原因服务名错误、服务未运行、对象路径错误。解决查看运行中的服务qdbus | grep 服务名。核对服务名和对象路径如 NetworkManager 的路径固定。5. 事件循环阻塞Loop not responding原因回调函数执行耗时操作阻塞事件循环。解决耗时操作放入线程池回调仅处理结果。六、使用注意事项Python 版本限制仅支持 Python 2.6/2.7、3.2/3.3不支持 3.4新项目优先考虑 python-sdbus 或 dasbus。事件循环必启所有信号监听、异步调用必须启动事件循环bus.loop.run()否则无响应。显式类型安全无自动类型转换参数类型必须严格匹配避免隐式错误。总线权限隔离系统总线SystemBus需 root 或特殊权限会话总线SessionBus仅当前用户可用。资源释放长时间运行的服务需在退出时释放总线连接避免文件描述符泄漏。替代库选择python-dbusx 已长期未更新新项目推荐python-sdbus现代异步支持 asyncio。dasbus简洁 API兼容 Python 3。pydbusPythonic 风格易用性高。总结python-dbusx 是轻量级、事件驱动的 D-Bus 库适合老旧 Python 版本、高并发 IPC 场景。核心优势是无 GLib 依赖、原生异步但需注意版本限制和显式类型要求。新项目建议优先选择现代替代库老旧系统维护可继续使用 python-dbusx。《动手学PyTorch建模与应用:从深度学习到大模型》是一本从零基础上手深度学习和大模型的PyTorch实战指南。全书共11章前6章涵盖深度学习基础包括张量运算、神经网络原理、数据预处理及卷积神经网络等后5章进阶探讨图像、文本、音频建模技术并结合Transformer架构解析大语言模型的开发实践。书中通过房价预测、图像分类等案例讲解模型构建方法每章附有动手练习题帮助读者巩固实战能力。内容兼顾数学原理与工程实现适配PyTorch框架最新技术发展趋势。
