Cooklang

gem 'cooklang'

require 'cooklang'

recipe_text = <<~RECIPE
  >> title: Pancakes
  >> servings: 4

  Crack @eggs{3} into a bowl, add @flour{125%g} and @milk{250%ml}.

  Heat #frying pan over medium heat for ~{5%minutes}.
  Pour batter and cook until golden.
RECIPE

recipe = Cooklang.parse(recipe_text)

# Access metadata
recipe.metadata['title']        # => "Pancakes"
recipe.metadata['servings']     # => 4

# Access ingredients
recipe.ingredients.each do |ingredient|
  puts "#{ingredient.name}: #{ingredient.quantity} #{ingredient.unit}"
end
# => eggs: 3
# => flour: 125 g
# => milk: 250 ml

# Parse from file
recipe = Cooklang.parse_file('pancakes.cook')

>> title: Uncle Roger's Fried Rice
>> servings: 2
>> prep_time: 10 minutes
>> cook_time: 8 minutes

Heat @peanut oil{1%tbsp} in #wok over high heat until smoking.

Add @garlic{3%cloves}(minced) and @shallots{2}(diced), stir-fry for ~{30%seconds}.

Add @eggs{3}(beaten) and scramble until almost set.

Add @day-old rice{3%cups} and stir-fry, breaking up clumps for ~{2%minutes}.

Season with @soy sauce{2%tbsp}, @sesame oil{1%tbsp}, @msg{1%tsp}, and @white pepper{0.5%tsp}.

Add @spring onions{3%stalks}(chopped) and stir for ~{30%seconds} more.

Serve immediately while hot!

{:metadata=>
  {:map=>
    {"title"=>"Uncle Roger's Fried Rice",
     "servings"=>"2",
     "prep_time"=>"10 minutes",
     "cook_time"=>"8 minutes"}},
 :sections=>
  [{:name=>nil,
    :content=>
     [{:type=>"step",
       :value=>
        {:items=>
          [{:type=>"text", :value=>"Heat "},
           {:type=>"ingredient", :index=>0},
           {:type=>"text", :value=>" in "},
           {:type=>"cookware", :index=>0},
           {:type=>"text", :value=>" over high heat until smoking."}],
         :number=>1}},
      {:type=>"step",
       :value=>
        {:items=>
          [{:type=>"text", :value=>"Add "},
           {:type=>"ingredient", :index=>1},
           {:type=>"text", :value=>" and "},
           {:type=>"ingredient", :index=>2},
           {:type=>"text", :value=>" and stir for "},
           {:type=>"timer", :index=>0}],
         :number=>2}}]}],
 :ingredients=>
  [{:name=>"peanut oil",
    :quantity=>
     {:value=>{:type=>"number", :value=>{:type=>"regular", :value=>1.0}},
      :unit=>"tbsp"}},
   {:name=>"garlic",
    :quantity=>
     {:value=>{:type=>"number", :value=>{:type=>"regular", :value=>3.0}},
      :unit=>"cloves"},
    :note=>"minced"},
   {:name=>"spring onions",
    :quantity=>
     {:value=>{:type=>"number", :value=>{:type=>"regular", :value=>3.0}},
      :unit=>"stalks"},
    :note=>"chopped"}],
 :cookware=>[{:name=>"wok"}],
 :timers=>
  [{:quantity=>
     {:value=>{:type=>"number", :value=>{:type=>"regular", :value=>30.0}},
      :unit=>"seconds"}},
   {:quantity=>
     {:value=>{:type=>"number", :value=>{:type=>"regular", :value=>2.0}},
      :unit=>"minutes"}}]}

# Recipe object
recipe.metadata         # Hash of metadata
recipe.ingredients      # Array of Ingredient objects
recipe.cookware         # Array of Cookware objects
recipe.timers           # Array of Timer objects
recipe.steps            # Array of Step objects
recipe.steps_text       # Array of plain text steps

# Ingredient
ingredient.name         # "flour"
ingredient.quantity     # 125
ingredient.unit         # "g"
ingredient.notes        # "sifted"

# Cookware
cookware.name          # "frying pan"
cookware.quantity      # 1

# Timer
timer.name            # "pasta"
timer.duration        # 10
timer.unit            # "minutes"