#bindings #xlock #mode #x11 #modes #download #suitable

tetromino-xlock-bindings

Rust 对 xlock 的绑定,适用于编写自定义 "模式"

1 个不稳定版本

0.1.0+v5.772024年5月19日

#412 in Unix API


用于 tetromino-xlock-mode

GPL-3.0-or-later

20KB
424 代码行,不含注释

tetromino-xlock-bindings

tetromino-xlock-bindings 提供了为 xlock(1) 创建绑定的方法 —— 一个流行的 X11 屏幕锁定程序。这些绑定适用于编写自定义 "模式",例如以模块的形式。

用法

该软件包包含为给定版本的 xlock 预生成的绑定,可以直接像其他软件包一样使用。似乎 xlock 考虑了兼容性,因此,为某个版本生成的绑定最终可能会生成与另一个版本兼容的二进制文件。此外,似乎很少有 configure 特性会影响 ABI 或 API,这可能在许多用例中使默认绑定适合使用。

尽管如此,该软件包提供了以下生成更新绑定的方法

  • 启用 download-xlock-source 特性将下载 xlock 源代码到 xlock-src/
    • 尊重 XLOCK_VERSION 环境变量,指定要下载的版本(默认为 5.73
    • 或者,可以使用 XLOCK_SRC_ARCHIVE_URL 环境变量来指定一个将下载并解压到 xlock-src/tar.xz URL
  • 如果启用 generate-xlock-bindings 特性,则将重新生成 bindings.rs
    • 默认情况下,将基于 xlock-src/ 中的内容生成绑定
    • 但是,如果设置了 XLOCK_SRC_ROOT 环境变量,则尝试根据引用目录中的数据创建它们

如果您没有安装 xlock,可以直接从 xlock-src 构建(在下载源代码后;请参见上文)。请参阅源代码中提供的说明。

请注意,默认情况下,所有 xlock "模式" 都在构建时静态链接到二进制文件中,这使得发布新的 "模式" 非常繁琐。在最近版本中,xlock 提供了对模块(共享对象)的实验性支持,这些模块可以在启动时被发现。您可能希望配置 xlock 以支持模块(有关如何操作的说明,请参阅它们的构建说明)。

无运行时依赖

~0–1.3MB
~16K SLoC