openfoodfacts-rust

This implements a wrapper around Open Food Facts API in Rust. Wiki page with a link to the Rust discussion channel: https://wiki.openfoodfacts.org/API/Rust

Installation

In the Cargo.toml file, under [dependencies], add the following lines:

openfoodfacts = { git = "https://github.com/openfoodfacts/openfoodfacts-rust.git"}
reqwest = {version = "0.11", features = ["blocking", "json"]}
serde_json = "1.0.73"

Examples

Get information about a product

let client = off::v0().build().unwrap();
let code = "3850102123681";

let response = client.product(code, None).unwrap();
let result_json = json!(response.json::<HashMap::<String, Value>>().unwrap());

Search products based on criteria

use openfoodfacts::{self as off, Locale, Output};
use serde_json::{json, Value};
use std::collections::HashMap;


fn main() {
    // create client and query with criteria
    let client = off::v2().build().unwrap();
    let query = client
        .query()
        .criteria("brands", "Vindija", Some("hr"));

    // run query and convert result as json
    let res = client.search(query, None).unwrap();
    let result_json = json!(res.json::<HashMap::<String, Value>>().unwrap());

    // parse json
    if let Some(products) = result_json["products"].as_array() {
        println!("That many products {}", products.len());
        for product in products {
            println!("Barcode: {}, name: {}, allergens: {}.", product["code"], product["product_name"], product["allergens"]);
        }
    }
}

More details about criteria here: https://openfoodfacts.github.io/documentation/docs/Product-Opener/api/#5Filtering

Features

Refer to the following API documentation: https://openfoodfacts.github.io/documentation/docs/Product-Opener/api/

List of methods of the client.

None can be replaced by output parameters (language (country code, cc; and optional language code, lc), page, page_size, fields (fields is used to reduce the response to only the fields you need)):

let output = Output::new()
    .locale(Locale::new("fr", None))
    .pagination(22, 20)
    .fields("url");

Whereas query can be created using criteria, ingredient, nutrient, as follows for v-0 and v-2, respectively:

let query = client
    .query()
    .criteria("brands", "contains", "Nestlé")
    .criteria("categories", "does_not_contain", "cheese")
    .ingredient("additives", "without")
    .ingredient("ingredients_that_may_be_from_palm_oil", "indifferent")
    .nutrient("fiber", "lt", 500)
    .nutrient("salt", "gt", 100);

let query = client
    .query()
    .criteria("brands", "Nestlé", Some("fr"))
    .criteria("categories", "-cheese", None)
    .nutrient_100g("fiber", "<", 500)
    .nutrient_serving("salt", "=", 100);

Third party applications

If you use this SDK, feel free to open a PR to add your application in this list.

Contributors