fond-domain 0.3.0

Domain types, traits, and errors for fond recipe manager
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};

/// A parsed recipe — the domain-level representation of a `.cook` file.
///
/// Fields map to Cooklang metadata plus parsed content.  
/// `raw_source` preserves the original `.cook` text so that
/// user-authored files are never silently rewritten.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct Recipe {
    pub slug: String,
    pub title: String,
    pub source: Option<String>,
    pub source_url: Option<String>,
    pub description: Option<String>,
    pub recipe_yield: Option<String>,
    pub prep_time: Option<String>,
    pub cook_time: Option<String>,
    pub total_time: Option<String>,
    pub servings: Option<String>,
    pub ingredients: Vec<RecipeIngredient>,
    pub steps: Vec<Step>,
    pub cookware: Vec<Cookware>,
    pub tags: Vec<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    /// Original `.cook` file content — preserved for lossless write-back.
    pub raw_source: Option<String>,
}

/// An ingredient reference within a recipe.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct RecipeIngredient {
    pub name: String,
    pub quantity: Option<String>,
    pub unit: Option<String>,
    pub note: Option<String>,
    pub optional: bool,
}

/// A single step (instruction) within a recipe.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct Step {
    pub section: Option<String>,
    pub body: String,
    pub timers: Vec<Timer>,
    pub order: u32,
}

/// A timer reference extracted from a step.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct Timer {
    pub name: Option<String>,
    pub duration: Option<String>,
}

/// A cookware reference extracted from a recipe.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct Cookware {
    pub name: String,
    pub quantity: Option<String>,
}