4 releases (breaking)

0.4.0 Jun 3, 2021
0.3.0 Jun 3, 2021
0.2.0 Jan 19, 2020
0.1.0 Nov 10, 2019

#26 in #day

29 downloads per month


293 lines

🥢 Welcome to openmensa-rs 🍴

GitHub GitHub PRs Welcome

rust library to interact with the openmensa api

Basic usage 🔧

This library provides a way to build request to the openmensa api and deserialize into rust structures. Provided are requests for Canteen, Meal and Day.

Requesting a list of all canteens

use openmensa_rs::request::CanteenRequest;

async fn main() {
    println!("List of all canteens: ");
    let list = CanteenRequest::new().build().await;
    println!("{:?}", list);

Requesting the meals for a single canteen

use openmensa_rs::{req_canteens, request::MealRequest};

async fn main() {
    let list = req_canteens().await.unwrap();
    // Print out the meals offered in the first canteen
    println!("Meals in the {} canteen on the {}", list[0].name(), chrono::Utc::today());
    let meals = MealRequest::new(list[0].id(), chrono::Utc::today())
    println!("{:?}", meals);

Shorthands for generic requests

If you want to get all information and specify no further constraints for your requests, you can use the provided shorthands req_canteens, req_days and req_meals.

use openmensa_rs::req_canteens;

async fn main() {
    let list = req_canteens().await.unwrap();
    println!("First canteens has id {} and is called {}", list[0].id(), list[0].name());

Add this crate 📦

All you have to do is add in your Cargo.toml under dependencies

openmensa-rs = "^0"


If you have any troubles using this library or you find any problems feel free to open an issue. Explaining your problem and if possible provide a short code snippet.


Johannes Wünsche

:octocat: @jwuensche
🐘 @fredowald@mastodon.social
🐦 @Fredowald

This README template is based on group works with fin-ger.

Show your support

Give a ⭐ if this project helped you!


~278K SLoC