Quickstart

from premier_league import RankingTable

# Get current season standings
ranking = RankingTable()
standings = ranking.get_ranking_list()

# Display top 5 teams
print(standings[0])  # Header row
for team in standings[1:6]:
    print(team)

['Position', 'Team', 'MP', 'W', 'D', 'L', 'GF', 'GA', 'GD', 'Points']
['1', 'Manchester City', '38', '32', '4', '2', '102', '31', '71', '100']
['2', 'Arsenal', '38', '28', '5', '5', '88', '43', '45', '89']
...

from premier_league import PlayerSeasonLeaders

# Get top 10 goalscorers
scorers = PlayerSeasonLeaders(stat_type='G')
top_scorers = scorers.get_top_stats_list(limit=10)

# Display results
for player in top_scorers[1:]:  # Skip header
    print(f"{player[0]} ({player[2]}): {player[3]} goals")

Erling Haaland (Manchester City): 36 goals
Harry Kane (Tottenham Hotspur): 30 goals
Ivan Toney (Brentford): 20 goals
...

from premier_league import MatchStatistics
from datetime import datetime

# Initialize match statistics
stats = MatchStatistics()

# Get Arsenal's recent games
arsenal_games = stats.get_team_games("Arsenal")

# Get games before a specific date
recent_games = stats.get_games_before_date(
    date=datetime(2024, 2, 1),
    limit=5,
    team="Liverpool"
)

print(f"Found {len(arsenal_games)} Arsenal games")

from premier_league import Transfers

# Initialize transfers for current season
transfers = Transfers()

# Get Chelsea's incoming transfers
chelsea_ins = transfers.transfer_in_table("Chelsea")

# Display transfers
print(chelsea_ins[0])  # Header
for transfer in chelsea_ins[1:]:
    print(transfer)