Fantasy Football Hub APIfantasyfootballhub.co.uk ↗

"""Walkthrough: Fantasy Football Hub SDK — bounded, re-runnable."""
from parse_apis.fantasyfootballhub_co_uk_api import (
    FantasyFootballHub, Topic, InputNotFound,
)

client = FantasyFootballHub()

# Check which gameweek we're in and when the next deadline falls.
ctx = client.gameweek_context.get()
print(f"Season {ctx.season} — GW{ctx.current_gameweek.number}",
      "finished" if ctx.current_gameweek.is_finished else "live")
print(f"Next deadline: GW{ctx.next_gameweek.number} @ {ctx.next_gameweek.deadline_at}")

# Browse the latest captain-pick articles.
for summary in client.article_summaries.list(topic=Topic.CAPTAIN_PICKS, limit=3):
    print(f"  [{summary.primary_category}] {summary.title}")

# Drill into the newest captain-pick article for full sections and player mentions.
pick = client.article_summaries.list(topic=Topic.CAPTAIN_PICKS, limit=1).first()
if pick is not None:
    article = pick.details()
    for section in (article.sections or []):
        if section.heading:
            print(f"  ## {section.heading}")
        for para in section.paragraphs[:2]:
            print(f"    {para[:120]}")
    for pm in article.players_mentioned:
        print(f"  Player: {pm.name} ({pm.price})")
    if article.members_only_continuation:
        print("  (full article requires membership)")

# Point-lookup an article by slug derived from the listing above.
if pick is not None:
    try:
        full = client.articles.get(slug=pick.slug)
        print(f"Fetched article: {full.title} by {full.author}")
    except InputNotFound:
        print("Article no longer available")

# Fixture difficulty for the next five gameweeks.
fd = client.fixture_difficulty.get()
print(f"Fixtures GW{fd.gameweek_start}–GW{fd.gameweek_end}:")
for team in fd.teams[:3]:
    easiest = min(team.fixtures, key=lambda f: f.difficulty_overall)
    print(f"  {team.team_short}: easiest GW{easiest.gameweek} vs {easiest.opponent_short}"
          f" (difficulty {easiest.difficulty_overall})")

print("exercised: gameweek_context.get / article_summaries.list /"
      " details / articles.get / fixture_difficulty.get")