dbus-next的更快版本

导航

验证详情

这些详情已经通过PyPI验证
维护者
来自gravatar.com的bdraco头像 bdraco

未验证详情

这些详情尚未通过PyPI验证
项目链接
元数据
  • 许可证： MIT许可证 (MIT)
  • 作者： 蓝牙设备作者
  • 要求： Python <4.0, >=3.8
分类

项目描述

dbus-fast

CI Status Documentation Status Test coverage percentage

Poetry black pre-commit

PyPI Version Supported Python versions License

这是一个从优秀的DBus next库（❤️）发展而来的dbus-next的更快版本。

安装

通过pip（或您喜欢的包管理器）安装此软件

pip安装dbus-fast

文档

dbus-fast是一个针对DBus的Python库，旨在成为一个性能出色、功能齐全的高级库，主要用于将应用程序集成到Linux桌面和移动环境中。

桌面应用程序开发人员可以使用此库通过实现常见的DBus标准接口或创建自定义插件接口，将他们的应用程序集成到桌面环境中。

桌面用户可以使用此库创建自己的脚本和实用程序，以与这些接口交互，从而定制他们的桌面环境。

dbus-fast计划在以下方面改进其他Python DBus库：

  • 零依赖和纯Python 3
  • 可选的cython扩展可用于加速（反）序列化
  • 专注于性能
  • 支持包括asyncio和GLib主循环在内的多个IO后端。
  • 非阻塞IO，适合GUI开发。
  • 针对Python的最新语言特性，以实现美观的服务和客户端。
  • 完全实现DBus类型系统，无需猜测类型。
  • 对库的所有功能进行集成测试。
  • 完整文档化的公共API。

安装

此库可在PyPi上找到，名称为dbus-fast。

pip3 install dbus-fast

客户端接口

要使用总线上的服务，库将构建一个代理对象，您可以使用它来调用方法、获取和设置属性，并监听信号。

更多信息，请参阅高级客户端概述。

以下示例连接到媒体播放器，并使用MPRIS DBus接口控制它。

from dbus_fast.aio import MessageBus

import asyncio


async def main():
    bus = await MessageBus().connect()
    # the introspection xml would normally be included in your project, but
    # this is convenient for development
    introspection = await bus.introspect('org.mpris.MediaPlayer2.vlc', '/org/mpris/MediaPlayer2')

    obj = bus.get_proxy_object('org.mpris.MediaPlayer2.vlc', '/org/mpris/MediaPlayer2', introspection)
    player = obj.get_interface('org.mpris.MediaPlayer2.Player')
    properties = obj.get_interface('org.freedesktop.DBus.Properties')

    # call methods on the interface (this causes the media player to play)
    await player.call_play()

    volume = await player.get_volume()
    print(f'current volume: {volume}, setting to 0.5')

    await player.set_volume(0.5)

    # listen to signals
    def on_properties_changed(interface_name, changed_properties, invalidated_properties):
        for changed, variant in changed_properties.items():
            print(f'property changed: {changed} - {variant.value}')

    properties.on_properties_changed(on_properties_changed)

    await asyncio.Event().wait()

asyncio.run(main())

服务接口

要定义总线上的服务，请使用ServiceInterface类，并使用装饰器修饰类方法，以指定DBus方法、属性和信号及其类型签名。

更多信息，请参阅高级服务概述。

from dbus_fast.service import ServiceInterface, method, dbus_property, signal, Variant
from dbus_fast.aio MessageBus

import asyncio

class ExampleInterface(ServiceInterface):
    def __init__(self, name):
        super().__init__(name)
        self._string_prop = 'kevin'

    @method()
    def Echo(self, what: 's') -> 's':
        return what

    @method()
    def GetVariantDict() -> 'a{sv}':
        return {
            'foo': Variant('s', 'bar'),
            'bat': Variant('x', -55),
            'a_list': Variant('as', ['hello', 'world'])
        }

    @dbus_property()
    def string_prop(self) -> 's':
        return self._string_prop

    @string_prop.setter
    def string_prop_setter(self, val: 's'):
        self._string_prop = val

    @signal()
    def signal_simple(self) -> 's':
        return 'hello'

async def main():
    bus = await MessageBus().connect()
    interface = ExampleInterface('test.interface')
    bus.export('/test/path', interface)
    # now that we are ready to handle requests, we can request name from D-Bus
    await bus.request_name('test.name')
    # wait indefinitely
    await asyncio.Event().wait()

asyncio.run(main())

低级接口

低级接口直接与DBus消息一起工作。

更多信息，请参阅低级接口概述。

from dbus_fast.message import Message, MessageType
from dbus_fast.aio import MessageBus

import asyncio
import json


async def main():
    bus = await MessageBus().connect()

    reply = await bus.call(
        Message(destination='org.freedesktop.DBus',
                path='/org/freedesktop/DBus',
                interface='org.freedesktop.DBus',
                member='ListNames'))

    if reply.message_type == MessageType.ERROR:
        raise Exception(reply.body[0])

    print(json.dumps(reply.body[0], indent=2))


asyncio.run(main())

使用python-dbus-fast的项目

贡献

欢迎贡献。开发在Github上进行。

提交之前，运行pre-commit run --all-files以运行代码检查器、代码格式化和测试套件。

版权

您可以在MIT许可证下使用此代码（见LICENSE）。

  • © 2019, Tony Crisci
  • © 2022, Bluetooth Devices作者

贡献者✨

感谢这些出色的人们（emoji键）

本项目遵循all-contributors规范。欢迎所有类型的贡献！

致谢

此包是用Cookiecutter和browniebroke/cookiecutter-pypackage项目模板创建的。

项目详情

验证详情

这些详情已经通过PyPI验证
维护者
来自gravatar.com的bdraco头像 bdraco

未验证详情

这些详情尚未通过PyPI验证
项目链接
元数据
  • 许可证： MIT许可证 (MIT)
  • 作者： 蓝牙设备作者
  • 要求： Python <4.0, >=3.8
分类

发布历史 发布通知 | RSS源

此版本

2.24.2

2.24.1

2.24.0

2.23.0

2.22.1

2.22.0

2.21.3

2.21.2

2.21.1

2.21.0

2.20.0

2.19.0

2.18.0

2.17.0

2.16.0

2.15.0

2.14.0

2.13.1

2.13.0

2.12.1

2.12.0

2.11.1

2.11.0

2.10.0

2.9.0

2.8.0 已撤回

此版本被撤回的原因

此版本在反序列化中引入了回归

2.7.0

2.6.0

2.5.0

2.4.0

2.3.0

2.2.0

2.1.0

2.0.1

2.0.0

1.95.2

1.95.1

1.95.0

1.94.1

1.94.0

1.93.1

1.93.0

1.92.0

1.91.4

1.91.3

1.91.2

1.91.1

1.91.0

1.90.2

1.90.1

1.90.0

1.89.0

1.88.0

1.87.6

1.87.5

1.87.4

1.87.3

1.87.2

1.87.1

1.87.0 已撤回

此版本被撤回的原因

与cython3的错误

1.86.0

1.85.0

1.84.2

1.84.1

1.84.0

1.83.1

1.83.0

1.82.0

1.81.0

1.80.0

1.79.0

1.78.0

1.77.0

1.76.0

1.75.1

1.75.0

1.74.2

1.74.1

1.74.0

1.73.1

1.73.0

1.72.0

1.71.0

1.70.0

1.69.0

1.68.0

1.67.0

1.66.0

1.65.0

1.64.0

1.63.0

1.62.0

1.61.1

1.61.0

1.60.0

1.59.2

1.59.1

1.59.0

1.58.0

1.57.0

1.56.0

1.55.0

1.54.0

1.53.0

1.52.0

1.51.0

1.50.0

1.49.0

1.48.0

1.47.0

1.46.0

1.45.0

1.44.0

1.43.0

1.42.0

1.41.0

1.40.0

1.39.0

1.38.0

1.37.0

1.36.0

1.35.0

1.34.0

1.33.0

1.32.0

1.31.0

1.25.0

1.21.16

1.21.15

1.21.14

1.21.13

1.21.12

1.21.11

1.21.10

1.21.9

1.21.8

1.21.7

1.21.6

1.21.3

1.21.2

1.21.1

1.21.0

1.20.0

1.19.0

1.18.0

1.17.0

1.16.0

1.15.3

1.15.2

1.15.1

1.15.0

1.14.0

1.13.0

1.12.0

1.11.0

1.10.0

1.9.0

1.8.0

1.7.0

1.6.0

1.5.1

1.5.0

1.4.0

1.3.0

1.2.0

1.1.9

1.1.8

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.0

下载文件

下载适合您平台的文件。如果您不确定选择哪一个，请了解更多关于安装包的信息。

源分发

dbus_fast-2.24.2.tar.gz (69.7 kB 查看哈希值)

上传时间 源

构建分发

dbus_fast-2.24.2-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux_2_5_x86_64.manylinux1_x86_64.manylinux2014_x86_64.whl (1.8 MB 查看哈希值)

上传时间 PyPy manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.5+ x86-64

dbus_fast-2.24.2-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB 查看哈希值)

上传时间 PyPy manylinux: glibc 2.17+ ARM64

dbus_fast-2.24.2-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux_2_5_x86_64.manylinux1_x86_64.manylinux2014_x86_64.whl (1.8 MB 查看哈希值)

上传时间 PyPy manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.5+ x86-64

dbus_fast-2.24.2-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB 查看哈希值)

上传时间 PyPy manylinux: glibc 2.17+ ARM64

dbus_fast-2.24.2-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux_2_5_x86_64.manylinux1_x86_64.manylinux2014_x86_64.whl (1.8 MB 查看哈希值)

上传时间 PyPy manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.5+ x86-64

dbus_fast-2.24.2-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.7 MB 查看哈希值)

上传时间 PyPy manylinux: glibc 2.17+ ARM64

dbus_fast-2.24.2-cp313-cp313-musllinux_1_2_x86_64.whl (5.6 MB 查看哈希值)

上传时间 CPython 3.13 musllinux: musl 1.2+ x86-64

dbus_fast-2.24.2-cp313-cp313-musllinux_1_2_aarch64.whl (5.3 MB 查看哈希值)

上传时间： CPython 3.13 musllinux: musl 1.2+ ARM64

dbus_fast-2.24.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (5.5 MB 查看哈希值)

上传时间： CPython 3.13 manylinux: glibc 2.17+ x86-64

dbus_fast-2.24.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (5.4 MB 查看哈希值)

上传时间： CPython 3.13 manylinux: glibc 2.17+ ARM64

dbus_fast-2.24.2-cp312-cp312-musllinux_1_2_x86_64.whl (5.6 MB 查看哈希值)

上传时间： CPython 3.12 musllinux: musl 1.2+ x86-64

dbus_fast-2.24.2-cp312-cp312-musllinux_1_2_aarch64.whl (5.4 MB 查看哈希值)

上传时间： CPython 3.12 musllinux: musl 1.2+ ARM64

dbus_fast-2.24.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (5.5 MB 查看哈希值)

上传时间： CPython 3.12 manylinux: glibc 2.17+ x86-64

dbus_fast-2.24.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (5.4 MB 查看哈希值)

上传时间： CPython 3.12 manylinux: glibc 2.17+ ARM64

dbus_fast-2.24.2-cp311-cp311-musllinux_1_2_x86_64.whl (5.5 MB 查看哈希值)

上传时间： CPython 3.11 musllinux: musl 1.2+ x86-64

dbus_fast-2.24.2-cp311-cp311-musllinux_1_2_aarch64.whl (5.4 MB 查看哈希值)

上传时间： CPython 3.11 musllinux: musl 1.2+ ARM64

dbus_fast-2.24.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (5.4 MB 查看哈希值)

上传于 CPython 3.11 manylinux: glibc 2.17+ x86-64

dbus_fast-2.24.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (5.4 MB 查看哈希值)

上传于 CPython 3.11 manylinux: glibc 2.17+ ARM64

dbus_fast-2.24.2-cp310-cp310-musllinux_1_2_x86_64.whl (5.1 MB 查看哈希值)

上传于 CPython 3.10 musllinux: musl 1.2+ x86-64

dbus_fast-2.24.2-cp310-cp310-musllinux_1_2_aarch64.whl (4.9 MB 查看哈希值)

上传于 CPython 3.10 musllinux: musl 1.2+ ARM64

dbus_fast-2.24.2-cp310-cp310-manylinux_2_31_x86_64.whl (4.0 MB 查看哈希值)

上传于 CPython 3.10 manylinux: glibc 2.31+ x86-64

dbus_fast-2.24.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (5.0 MB 查看哈希值)

上传于 CPython 3.10 manylinux: glibc 2.17+ x86-64

dbus_fast-2.24.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (5.0 MB 查看哈希值)

上传于 CPython 3.10 manylinux: glibc 2.17+ ARM64

dbus_fast-2.24.2-cp39-cp39-musllinux_1_2_x86_64.whl (5.1 MB 查看哈希值)

上传于 CPython 3.9 musllinux: musl 1.2+ x86-64

dbus_fast-2.24.2-cp39-cp39-musllinux_1_2_aarch64.whl (4.9 MB 查看哈希值)

上传于 CPython 3.9 musllinux: musl 1.2+ ARM64

dbus_fast-2.24.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (5.0 MB 查看哈希值)

上传于 CPython 3.9 manylinux: glibc 2.17+ x86-64

dbus_fast-2.24.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (5.0 MB 查看哈希值)

上传于 CPython 3.9 manylinux: glibc 2.17+ ARM64

dbus_fast-2.24.2-cp38-cp38-musllinux_1_2_x86_64.whl (4.2 MB 查看哈希)

上传于 CPython 3.8 musllinux: musl 1.2+ x86-64

dbus_fast-2.24.2-cp38-cp38-musllinux_1_2_aarch64.whl (4.0 MB 查看哈希)

上传于 CPython 3.8 musllinux: musl 1.2+ ARM64

dbus_fast-2.24.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.1 MB 查看哈希)

上传于 CPython 3.8 manylinux: glibc 2.17+ x86-64

dbus_fast-2.24.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (4.0 MB 查看哈希)

上传于 CPython 3.8 manylinux: glibc 2.17+ ARM64

支持者