theunkn0wn1 / themealdb-rs

Rust bindings to `themealdb`'s json API

mealdb-rs

This rust crate provides a reqwest-based async interface to themealdb.com.

Usage

Currently, this crate only supports the json API v1 endpoints.

To use this crate, instantiate an instance of the API wrapper.

use mealdb::preamble::*;

#[tokio::main]
pub async fn main() {
    println!("hello, world!");

    // Create handle to the API
    let api = mealdb::V1::new("https://www.themealdb.com", "<YOUR API KEY HERE>");
    // ...
    }

this V1 api wrapper exposes the supported methods of themealdb's API.

For example, getting all the meals with a title containing chicken:

    // Searching for meals that contain a keyword
    println!("finding all meals with `chicken` in the name...");
    let meals = api
        .search_meal_by_name("chicken")
        .await
        .expect("query failed.")
        .expect("no results.");
    meals
        .iter()
        .for_each(|meal| println!("meal name :: {:?} meal id :: {}", meal.name, meal.id));

themealdb-rs's Issues

Patreon-only endpoints (Best effort)

github actions (lint, build)

V0.1.0 tracking

There are some outstanding features that need to be implemented prior to a release

Basic endpoints:

• Search meal by name
• List all meals by first letter
• Lookup full meal details by id
• Lookup a single random meal
• List all meal categories
• List all Categories (NOT to be confused with List all meal categories, this endpoint returns something else.)
• List all areas
• List all Ingredients
• Filter by main ingredient
• Filter by Category
• Filter by Area
• #2

CI:

• #4
• test suite