因此，使用 && 将程序链起来或使用 || exit 1 来扩展程序调用，以便正确地使提供程序命令失败，这是一个好主意。例如，可以使用 which <program> || exit 1 来测试管道中使用的所需程序的可用性。

还要记住要 引用输入文件（例如 "%(file)s"），因为路径可能包含空格。不应在 %(outfile)s（以及 %(tmpdir)s）中包含任何空格，但引用它们也无妨。

示例

让我们看一个示例，并指定一个为 PDF 和 postscript 文件提供缩略图的提供程序。两者都可以使用相同的命令转换为缩略图，这就是为什么可以将两者处理在一个提供程序中。

请注意，AllMyToes 的实际默认配置使用不同的提供程序定义来实现更具体的元块命令。这个定义仅作为示例。

PDF 文件的 MIME 类型为 application/pdf，postscript 文件的 MIME 类型为 application/postscript。

- mimes: [application/pdf, application/postscript]
  commands:
    - evince-thumbnailer -s %(size)s "%(file)s" %(outfile)s
    - convert -thumbnail %(size)sx%(size)s -background white %(file)s[0] PNG:%(outfile)s
  meta:
    'Thumb::Document::Pages':
      - |
        which exiftool || exit 1
        exiftool "%(file)s" | awk '/^Page Count/ {print $4}' | sed 's/[^0-9]*//g'
      - | 
        which gs || exit 1
        gs -o /dev/null -sDEVICE=bbox "%(file)s" 2>&1 | grep HiResBoundingBox | wc -l
  revision: 1

首先，定义此提供程序将使用的 MIME 类型。

commands 部分首先尝试使用 evince-thumbnailer 在 %(outfile)s 中创建缩略图。如果 evince-thumbnailer 存在，则提供图像的任务已完成，不会执行第二个命令。

如果 evince-thumbnailer 不可用，第一个命令将失败，AllMyToes 将执行第二个命令，该命令使用 ImageMagick 的 convert。如果 convert 也不可用，则缩略图创建失败，AllMyToes 将返回错误。

首先尝试 evince-thumbnailer，因为它更快，我们更喜欢使用它。

如果两个命令中的任何一个成功，AllMyToes 将评估 meta 部分。在这个例子中，我们只有一个具有元键 Thumb::Document::Pages 的元块。此元块也有两个命令，同样，如果第一个命令失败，AllMyToes 将仅执行第二个命令。

第一个命令依赖于 exiftool，第二个命令依赖于 Ghostscript（gs）。因为它们都用于管道中，所以我们首先检查它们是否存在，如果不存在则退出并返回 1。示例展示了如何将多行脚本用作命令。

两个元数据命令都返回值作为输出到 stdout 的 Thumb::Document::Pages 元数据块的值。

有关更多示例，请参阅 默认提供程序配置。

这有什么用？

我的个人动机是使用缩略图来预览终端文件管理器中的图像，如 joshuto 和 ranger 中的图像。但是，AllMyToes在任何需要以脚本环境显示尺寸受限图像的情况下都可能很有用，例如作为桌面通知中的图标，或在基于终端的应用程序中的其他图像叠加，或桌面小部件；在这些情况下，加载全尺寸图像会消耗不必要的的时间和CPU资源。

安装

Linux X86-64 二进制文件（实验性）

从发布页面下载最新版本的二进制文件。使下载的文件可执行（chmod +x allmytoes）并将其放置在您的PATH目录中（例如mv allmytoes ~/local/bin）。

通过cargo的最新发布版

cargo install allmytoes

通过cargo获取最新版本

cargo install --git https://gitlab.com/allmytoes/allmytoes.git

从仓库克隆

git clone https://gitlab.com/allmytoes/allmytoes.git
cd allmytoes
cargo build --release

生成的二进制文件将在target/release/allmytoes。

一些规格

• Freedesktop.org 缩略图规范：AllMyToes努力遵守freedesktop.org 缩略图规范。现在应该实现了标准的所有相关部分。
• AllMyToes不会创建缓存目录（$XDG_CACHE_HOME或~/.cache）。如果缓存目录不存在，AllMyToes将以错误终止。（以后可能会改变。）
• 如果不存在，AllMyToes将在缓存目录下创建缩略图目录和特定大小的子目录。
• AllMyToes只接受常规文件和常规文件的符号链接作为输入。将来可能会支持目录。没有计划支持其他文件类型。

缩略图元数据块

缩略图 - 所有都是PNG格式 - 具有一定的元数据条目，每个条目都是一个PNG“tEXt”块，具有键和值。freedesktop.org 缩略图标准描述了一些必需的和一些可选的键。（见标准中的“缩略图创建部分”）。AllMyToes实现了所有这些。以下表格列出了AllMyToes创建的所有元数据条目。

† 仅适用于图像输入文件

路线图

计划的主要里程碑

• 遵守 freedesktop.org 规范的强制要求，并具有基本健壮性（见 %1）。然后 AllMyToes 将升级到 0.1.0 版本。
• 通过配置提供预览的其他程序支持非图像文件格式（视频、字体、文档等）。(#13)
• 支持 共享仓库。
• 根据配置的路径模式支持其他缩略图仓库位置。（不属于 freedesktop.org 标准。）

另请参阅 我的开发板。

测试

一些东西通过标准 Rust 单元测试进行测试。可以使用 cargo test 运行这些测试。

大多数 AllMyToes 功能通过 BDD 测试框架进行端到端测试，该框架是 Python Behave。这些测试使用文件系统上的真实图像和一个 allmytoes 调试构建，作为子进程启动。

BDD 测试位于 test 子目录中。测试定义作为 feature-文件位于 test/features 中。

运行 BDD 测试

拥有 Python >= 3.10 环境和所需的依赖项。例如，使用 virtualenv，然后运行 pip install -r test/requirements.txt。

拥有 AllMyToes 的 调试 构建。 target/debug/allmytoes 将是受测试的二进制文件。

然后，要运行测试，请使用 cd 进入 test 目录并运行 behave。

关于缺少的测试/未测试事物的说明

• XDG_CACHE_HOME 的评估
• 对错误和缺失的文件扩展名进行 MIME 类型探测（如果 CI 失败，请检查是否在使用的 docker img 上安装了 MIME-db）
• --force-creation
• 当输入文件不可读时返回错误，无论是否存在有效的缩略图。
• 更新现有但过时的缩略图
• 在不存在、不可读、无法解码的输入文件上出错
• 拒绝处理既不是常规文件也不是常规文件符号链接的文件
• 所有 tEXt 元数据（mtime 和 URI 是隐式测试的，当然）
• #61

您可能更喜欢使用此替代方案

• Tumbler 是一个功能更丰富且更为成熟的用于同一目的的工具，但需要作为服务运行，并使用 DBUS 进行通信。

  我没有使用 Tumbler，因为我想要为我的脚本拥有更简单的东西。

AllMyToes 作为 Rust 库

AllMyToes 可以作为一个 Rust 库来获取给定图片的缩略图。您可以在 crates.io 上找到这个软件包。

AllMyToes 具有非常简洁的接口。有一个用于配置的 struct（AMT），它还提供了一个获取缩略图的功能（get）。然后，有一个枚举类型用于指定缩略图大小（ThumbSize），一个用于结果的 struct（Thumb），以及一个用于可能的错误类型的枚举（ToeErrorType）。

示例

use std::path::Path;
use allmytoes::{AMTConfiguration, AMT, ThumbSize};

fn main() {
    // The configuration for allmytoes
    // Usually, the defaults are fine.
    let configuration = AMTConfiguration::default();

    // An instance of allmytoes that can be used to provide thumbnails
    let amt = AMT::new(&configuration);

    // The file for which we want a thumbnail as a `std::path::Path`.
    let input_file = Path::new("/tmp/image.jpg");
    
    // The size of the thumbnail we want
    let thumb_size = ThumbSize::Large;

    // Get a thumbnail
    match amt.get(
        input_file,
        thumb_size,
    ) {
        Ok(thumb) => {
            println!("The thumb is here: {}", thumb.path)
        }
        Err(error) => println!(
            "Error '{:?}' occurred when trying to provide the thumb. ({})",
            error,
            error.msg(),
        ),
    }
}

许可协议：GPL 3

AllMyToes 是免费软件：您可以在自由软件基金会发布的 GNU 通用公共许可证的条款下重新分发和/或修改它，许可证版本为 3，或者（根据您的选择）许可证的任何后续版本。

AllMyToes 的分发旨在使其有用，但没有任何保证；甚至没有关于其商售性或适用于特定目的的隐含保证。有关详细信息，请参阅 GNU 通用公共许可证。

您应已收到 GNU 通用公共许可证的副本。如果没有，请参阅 https://gnu.ac.cn/licenses/。