Vignerons Independants APIvignerons-independants.com ↗

"""Walkthrough: Vignerons Indépendants SDK — fairs, exhibitors, and winemaker wines."""
from parse_apis.vignerons_independants_com_api import (
    VigneronsIndependants,
    WineRegion,
    CulturalMode,
    InputNotFound,
)

client = VigneronsIndependants()

# List upcoming wine fairs, capped at 3.
for fair_summary in client.fair_summaries.list(limit=3):
    print(fair_summary.name, "|", fair_summary.start_date_text, "-", fair_summary.end_date_text)

# Drill into the first fair's full details.
fair_summary = client.fair_summaries.list(limit=1).first()
if fair_summary is not None:
    fair = fair_summary.details()
    print(f"\n{fair.name} ({fair.edition})")
    print(f"  Venue: {fair.venue_name}, {fair.venue_address}")
    print(f"  Dates: {fair.start_date} → {fair.end_date}")
    print(f"  Exhibitors: {fair.exhibitor_count}")
    for hours in fair.opening_hours:
        print(f"  {hours}")

    # Browse exhibitors at this fair, filtered by region.
    for exhibitor in fair.exhibitors.list(wine_region=WineRegion.BORDEAUX, limit=5):
        print(f"  Stand {exhibitor.stand_code}: {exhibitor.name} ({exhibitor.region})")

# Search vignerons and view one winemaker's full wine list.
vigneron = client.vignerons.search(
    cultural_mode=CulturalMode.BIO,
    wine_region=WineRegion.JURA,
    limit=1,
).first()

if vigneron is not None:
    profile = vigneron.details()
    print(f"\n{profile.name} — {profile.cultural_mode}")
    print(f"  Owner: {profile.owner}")
    print(f"  Appellations: {', '.join(profile.appellations)}")
    for wine in profile.wines[:3]:
        medal_info = f", {wine.medal_count} medal(s)" if wine.medal_count else ""
        print(f"  {wine.producer_name} | {wine.appellation} | {wine.color} {wine.sweetness or ''}{medal_info}")

# Point-lookup a fair by slug, with error handling for unknown fairs.
try:
    detail = client.fairs.get(fair_slug="lyon-halle-tony-garnier-2026")
    print(f"\nDirect lookup: {detail.name}, services: {', '.join(detail.services[:3])}")
except InputNotFound:
    print("Fair not found.")

print("\nexercised: fair_summaries.list / details / exhibitors.list / vignerons.search / vigneron.details / fairs.get")