buongiornissimo-rs

Crates.iobuongiornissimo-rs
lib.rsbuongiornissimo-rs
version0.2.1
sourcesrc
created_at2022-09-12 11:55:31.072642
updated_at2023-05-23 16:03:37.082793
descriptionScrapes for the best Italian boomer flavoured images
homepagehttps://github.com/veeso/buongiornissimo-rs
repositoryhttps://github.com/veeso/buongiornissimo-rs
max_upload_size
id663703
size119,270
Christian Visintin (veeso)

documentation

https://docs.rs/buongiornissimo-rs

README

buongiornissimo-rs

~ Scrapes for the best Italian boomer flavoured images ~

Get started Β· Documentation

Developed by @veeso

Current version: 0.2.1 (23/05/2023)

License-MIT Repo stars Downloads counter Latest version Ko-fi

Build CI Coveralls Docs



About buongiornissimo-rs πŸ“·

Buongiornissimo-rs is a Rust library to scrape for Buongiornissimo caffè Italian boomer flavoured images from a Rust application. It supports different buongiornissimo providers to scrape the images from. It supports many kind of "greetings", such as the classic "buongiornissimo", but also the holiday-based greetings, like "natale", "sacro cuore di Gesù" and "Giovedì grasso". Everthing is provided through a simple and totally async API.

Features 🎁

  • Different providers to prevent api outages and to differentiate the contents.
  • Support for different kind of greetings based on the current date
  • Utilities functions to retrieve the moveable feasts date (such as Easter, Carnival, Corpus domini...). requires the moveable-feasts feature
  • A super comfy function greeting_of_the_day() to retrieve the best greeting for the day

Get started 🏁

Add buongiornissimo-rs to your Cargo.toml πŸ¦€

buongiornissimo-rs = "^0.2.0"

Supported features are:

  • no-log: disable logging
  • moveable-feasts (default): enable getters for moveable feasts

Scrape for buongiornissimo β˜•

use buongiornissimo_rs::{IlMondoDiGrazia, Scrape};
use chrono::Local;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let motd = buongiornissimo_rs::greeting_of_the_day(Local::today().naive_local(), true);
    let urls = IlMondoDiGrazia::default().scrape(motd).await?;
    // Do whatever you want with the scraped images...
    Ok(())
}

Currently these providers are supported:

Examples πŸ”

You can check the example to scrape a buongiornissimo imagerunning the example, which is located at examples/buongiornissimo.rs:

cargo run --example buongiornissimo --features moveable-feasts

Documentation πŸ“š

The developer documentation can be found on Rust Docs at https://docs.rs/buongiornissimo-rs


Support the developer β˜•

If you like buongiornissimo-rs and you're grateful for the work I've done, please consider a little donation πŸ₯³

You can make a donation with one of these platforms:

ko-fi PayPal bitcoin litecoin


Contributing and issues 🀝🏻

Contributions, bug reports, new features and questions are welcome! πŸ˜‰ If you have any question or concern, or you want to suggest a new feature, or you want just want to improve buongiornissimo-rs, feel free to open an issue or a PR.

Please follow our contributing guidelines


Changelog ⏳

View buongiornissimo-rs's changelog HERE


License πŸ“ƒ

buongiornissimo-rs is licensed under the MIT license.

You can read the entire license HERE

Commit count: 7

cargo fmt