Google图片搜索

一个基于提供的参数搜索Google图片的crate。由于仅使用单个请求获取图片的限制，每次请求最多只能找到约100张图片。这些图片可能受版权保护，因此您不应该对它们进行任何可受惩罚的操作，如用于商业用途。

参数

有2个必需参数，以及各种不同的参数。

搜索参数

这些是可选参数，Google可以使用这些参数过滤图片，有助于缩小搜索范围。它们通过Arguments结构体的各种方法使用。每个参数都包含在一个包含所有可能选项的enum中。

示例

使用异步 API 需要某种异步运行时，通常是 tokio，这可以像这样添加到您的 Cargo.toml

[dependencies]
image_search = "0.4"
tokio = { version = "1", features = ["full"] }

它可以这样使用

extern crate tokio;
extern crate image_search;

use std::path::PathBuf;
use image_search::{Arguments, Color, urls, search, download};
 
#[tokio::main]
async fn main() -> Result<(), image_search::Error> {
    let args = Arguments::new("example", 10)
        .color(Color::Gray)
        .directory(PathBuf::from("downloads")); // Only affects the download function
     
    let _image_urls = urls(args.clone()).await?;
    let _images = search(args.clone()).await?;
    let _paths = download(args).await?;
 
    Ok(())
}

阻塞

有一个可选的 "阻塞" API 可以启用

[dependencies]
image_search = { version = "0.4", features = ["blocking"] }

它可以这样调用

extern crate image_search;

use std::path::PathBuf;
use image_search::{Arguments, Time, blocking::{urls, search, download}};

fn main() -> Result<(), image_search::Error> {
    let args = Arguments::new("example", 10)
        .time(Time::Month)
        .directory(PathBuf::from("downloads")); // Only affects the download function
    
    let _image_urls = urls(args.clone())?;
    let _images = search(args.clone())?;
    let _paths = download(args)?;

    Ok(())
}

客户端

这个crate使用 surf 来进行 HTTP 请求，以便允许自定义用于 HTTP 请求的客户端。这可以使程序通过 CURL 与 C 交互，通过 hyper 或 async-h1 以纯 Rust 交互，甚至 WASM。与 surf 一样，可以通过功能自定义使用的客户端。为了更改，您必须在 Cargo.toml 中设置 default-features=false，因为默认使用 curl。可能的后端在此列出

• curl：通过 isahc 使用 CURL 通过 CURL 作为 HTTP 后端。
• hyper (默认)：使用 hyper 作为 HTTP 后端。
• wasm：使用 window.fetch 作为 HTTP 后端。
• h1：使用 async-h1 作为具有原生 TLS 的 HTTPS 的 HTTP 后端。
• rustls：使用 async-h1 作为 HTTP 后端，并使用 rustls 进行 HTTPS。