An open API service indexing awesome lists of open source software.

https://github.com/towinok/anime-grubber

Convenient library for extracting images of cute (or not so cute) characters from websites.
https://github.com/towinok/anime-grubber

anime parser waifu-pics

Last synced: 6 months ago
JSON representation

Convenient library for extracting images of cute (or not so cute) characters from websites.

Awesome Lists containing this project

README

          

# anime-grubber
[![Crates.io](https://img.shields.io/crates/v/anime-grubber.svg)](https://crates.io/crates/anime-grubber)
[![Documentation]( https://img.shields.io/badge/docs-doc.rs-red)](https://docs.rs/anime-grubber)
[![License](https://img.shields.io/crates/l/anime-grubber.svg)](LICENSE)
удобная библиотека для извлечения изображений милых (или не совсем) персонажей с веб-сайтов.

## Возможности

- Извлечение изображений и GIF с аниме-сайтов и других ресурсов.
- Поддержка работы с различными категориями медиа, включая SFW (Safe for Work) и NSFW (Not Safe for Work).
- Лёгкая интеграция с асинхронными приложениями на базе **Tokio**.
- Встроенные агенты для работы с популярными API (например, Waifu.pics).
- Логирование событий для отладки и отслеживания процесса загрузки медиа.

## Агенты

- [Vaifu.pics](https://waifu.pics/docs)

## Установка

Пропишите в консоль:
```sh
cargo add anime-grubber
```

или

Добавьте **anime-grubber** в ваш `Cargo.toml`:

```toml
[dependencies]
anime-grubber = "0"
```

## Использование

```rust
use anime_grubber::agents::waifu_pics::{Waifu, Categories, SFW};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
let instance = Waifu::new(Categories::SFW(SFW::Dance));
let image = instance.get().await?;
println!("Fetched image URL: {}", image);
Ok(())
}
```

## Примеры использования

### Извлечение одного изображения

Этот пример показывает, как можно получить одно изображение из категории **SFW::Dance**:

```rust
use anime_grubber::agents::waifu_pics::{Waifu, Categories, SFW};
use tracing::info;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
let instance = Waifu::new(Categories::SFW(SFW::Dance));
let image = instance.get().await?;
info!("Fetched image URL: {}", image);
Ok(())
}
```

### Извлечение нескольких изображений

Получение сразу нескольких изображений из той же категории:

```rust
use anime_grubber::agents::waifu_pics::{Waifu, Categories, SFW};
use tracing::info;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
let instance = Waifu::new(Categories::SFW(SFW::Dance));
let images = instance.get_many().await?;
assert_eq!(images.len(), 30);
info!("{:#?}", images);
Ok(())
}
```

## Логирование

Для удобства отладки используется библиотека **tracing**. Пример настройки глобального логгера можно увидеть в тестах.

```rust
use tracing_subscriber::FmtSubscriber;

tracing::subscriber::set_global_default(
FmtSubscriber::builder()
.with_max_level(tracing::Level::DEBUG) // or you can use INFO .with_max_level(tracing::Level::INFO)
.pretty()
.without_time()
.finish(),
).expect("Failed to set global default subscriber");
```

## Тестирование

Библиотека содержит примеры тестов, которые можно найти в модуле [Tests](./tests/):

## Лицензия

Этот проект распространяется под лицензией **MIT**. Подробности см. в файле [LICENSE](./LICENSE).