Sanfernandocoffeeco APIsanfernandocoffeeco.com ↗

"""Walkthrough: browse San Fernando Coffee locations, menus, and item customizations."""
from parse_apis.sanfernandocoffeeco_com_api import SanFernandoCoffee, InputNotFound

client = SanFernandoCoffee()

# List all store locations, capped to 5.
for loc in client.locations.list(limit=5):
    print(loc.name, loc.city, loc.state, loc.zipcode)

# Pick the first location and fetch its full menu.
location = client.locations.list(limit=1).first()
if location is not None:
    menu_data = location.menu()
    print(f"{menu_data.location_name} — {menu_data.item_count} items")
    print(f"  {menu_data.address.address1}, {menu_data.address.city}, {menu_data.address.state}")

    # Walk each menu's groups and print item summaries.
    for menu in menu_data.menus:
        print(f"\n{menu.name}")
        for group in menu.groups:
            print(f"  {group.name}")
            for item in group.items:
                stock = "" if not item.out_of_stock else " [OUT OF STOCK]"
                print(f"    ${item.price:.2f} — {item.name}{stock}")

    # Drill into the first item's detail to see customization options.
    first_group = next((g for m in menu_data.menus for g in m.groups if g.items), None)
    if first_group is not None:
        summary = first_group.items[0]
        try:
            detail = location.items.get(item_id=summary.item_id)
        except InputNotFound:
            print(f"Item {summary.item_id} not found at this location")
        else:
            print(f"\nDetail: {detail.name} — ${detail.price:.2f}")
            print(f"  {detail.description}")
            for mg in detail.modifier_groups:
                req = "required" if mg.required else "optional"
                print(f"  [{req}] {mg.name} (pick {mg.min_selections}–{mg.max_selections})")
                for opt in mg.options:
                    adj = f" +${opt.price:.2f}" if opt.price else ""
                    print(f"    {opt.name}{adj}")

print("\nexercised: locations.list / location.menu / location.items.get")