概述

这是一个用于从各种图像搜索后端（例如Unsplash、Google）检索图像的命令行工具。此工具主要为了教育目的而开发，以向人们展示如何开发插件友好的Python应用程序。此外，它是一个示例项目，展示了如何有效地搭配几个流行的Python库来编写命令行应用程序。

为了方便我们的插件架构，使用了pluggy库。其他使用的库包括以下

• click：用于结构化命令行应用程序 🖱 💻
• pydantic：用于处理配置文件验证 🗃
• rich：用于UX/UI元素，通常使应用程序更美观 🌈

为什么是“latz”

"latz" 简短且易于输入！在编写CLI程序时这非常重要。我还可能添加地理位置搜索功能，因此它是“纬度”一词的参考。

快速入门

安装

latz 可在PyPI上安装

# Run from a new virtual environment
$ pip install latz

或我的anaconda.org频道

$ conda create -n latz 'thath::latz'

如果您对自行研究代码感兴趣，也可以在本地运行它

$ git clone git@github.com:/travishathaway/latz.git
$ cd latz
# Create a virtual environment however you like..
$ pip install -e .

用法

Latz最初配置了“unsplash”图像搜索后端。要使用它，您需要创建一个Unsplash账户并创建一个测试应用程序。获取“access_key”后，您可以通过运行以下命令设置此值

$ latz config set search_backend_settings.unsplash.access_key=<YOUR_ACCESS_KEY>

配置完成后，您可以在Unsplash上搜索兔子的图片

$ latz search "bunny"
[
    ImageSearchResultSet(
        results=(
            ImageSearchResult(
                url='https://unsplash.com/photos/u_kMWN-BWyU/download?ixid=MnwzOTMwOTR8MHwxfHNlYXJjaHwxfHxidW5ueXxlbnwwfHx8fDE2Nzk0MTA2NzQ',
                width=3456,
                height=5184
            ),
            # ... results truncated
        ),
        total_number_results=10,
        search_backend='unsplash'
    )
]

配置

latz的配置存储在您的家目录中，格式为JSON。下面是默认配置的一个示例：

{
  "search_backends": [
    "unsplash"
  ],
  "search_backend_settings": {
    "placeholder": {
      "type": "kitten"
    },
    "unsplash": {
      "access_key": "your-access-key"
    }
  }
}

latz还会在您当前的工作目录中搜索.latz.json文件，并使用该文件配置。当前工作目录中的文件将优于家目录中的位置。

要查看其他可用的图像搜索后端，请参阅下方的可用的图像搜索后端。

可用的图像搜索后端

以下是可用的搜索后端列表：

内置

• "unsplash"
• "placeholder"

第三方

• latz-imgur

如何扩展和编写自己的图像搜索后端

请参阅文档中的创建插件指南。