Doctor

Analyze your recipe collection for issues and improvements.

Usage#

cook doctor [OPTIONS] [COMMAND]

Subcommands#

validate#

Validate all recipes for syntax errors and warnings.

cook doctor validate [OPTIONS]

Checks for: syntax errors, warnings, missing recipe references, invalid units or quantities.

aisle#

Check for ingredients missing from your aisle configuration.

cook doctor aisle [OPTIONS]

Finds ingredients not assigned to any store section in aisle.conf. Each one is reported with how many recipes use it:

3 ingredients not found in aisle configuration:
  - cumin powder (1 recipe)
  - cummin (2 recipes)
  - ground cinnamon (12 recipes)

An ingredient used by one recipe where the rest of the collection spells it another way is usually a typo rather than a missing aisle entry. Pass --show-recipes to name the files to go and fix:

3 ingredients not found in aisle configuration:
  - cumin powder (1 recipe)
      Curries/Rogan Josh.cook
  - cummin (2 recipes)
      Curries/Dal.cook
      Soups/Harira.cook

pantry#

Check which recipe ingredients are in your pantry inventory.

cook doctor pantry [OPTIONS]

Shows which ingredients are already tracked in pantry.conf, with how many recipes use each. --show-recipes names them, so you can see which of your recipes an item in stock is keeping off the shopping list.

Examples#

# Run all checks
cook doctor

# Validate recipes
cook doctor validate

# Strict mode for CI/CD
cook doctor validate --strict

# Check for uncategorized ingredients
cook doctor aisle

# ...and find the recipes that misspell them
cook doctor aisle --show-recipes

# Check pantry coverage
cook doctor pantry