Farmersfridge APIfarmersfridge.com ↗

"""Walkthrough: Farmer's Fridge SDK — browse the menu, find locations, check stock."""
from parse_apis.farmer_s_fridge_api import (
    FarmersFridge, Category, AccessType, LocationType, ProductNotAtLocation
)

client = FarmersFridge()

# List all menu categories available for filtering.
for cat in client.productsummaries.categories(limit=10):
    print(cat)

# Get high-protein products from the menu.
product = client.productsummaries.list(category=Category.HIGH_PROTEIN, limit=1).first()
if product:
    print(product.name, product.sku, product.calories)

    # Drill into full product details (nutrition, allergens, ingredients).
    detail = product.details()
    print(detail.name, detail.allergens, detail.nutrition_facts[:60])
    for comp in detail.components:
        print(comp.name, comp.ingredients[:80])

# Find a public airport location and check its live fridge inventory.
location = client.locations.list(access_type=AccessType.PUBLIC, location_type=LocationType.AIRPORT, limit=1).first()
if location:
    print(location.name, location.address, location.coordinates.latitude)
    for item in location.menu(limit=3):
        print(item.prettyName, item.price, item.count, item.foodInfo.allergens)

# Check product availability at a specific fridge — typed error on miss.
if product and location:
    try:
        avail = location.check_product(slug=product.slug)
        print(avail.status, avail.price, avail.stock_count)
    except ProductNotAtLocation as exc:
        print(f"Not stocked: {exc}")

# Retrieve filter options for locations.
opts = client.locations.filter_options()
print(opts.access_types, opts.location_types)

print("exercised: productsummaries.list / categories / details / locations.list / filter_options / menu / check_product")