hanabi-league/src/fetch_games.py

import json
from dataclasses import dataclass
from typing import Dict, List, Optional

import platformdirs
import requests_cache
import psycopg2.extras

import hanabi.live.hanab_live
import hanabi.hanab_game

import constants
import games_db_interface
import database
import utils
from database import conn_manager
from log_setup import logger
from config import config_manager

# This ensures that we do not pose too many requests to the website, especially while in development where we
# might frequently re-initialize the database.
session = requests_cache.CachedSession(
    platformdirs.user_cache_dir(constants.APP_NAME) + '/hanab.live.requests-cache',
    urls_expire_after={
        # Game exports will never change, so cache them forever
        'hanab.live/export/*': requests_cache.NEVER_EXPIRE,
         # Cash history requests for 5 minutes, this seems like a reasonable time
        'hanab.live/api/v1/history-full/*': constants.USER_HISTORY_CACHE_TIME
    }
)

@dataclass
class GameInfo:
    game_id: int
    num_players: int
    variant_id: int
    seed: str
    score: int
    num_turns: int
    user_ids: List[int]
    normalized_usernames: List[str]
    datetime_started: str
    datetime_ended: str


def fetch_games_for_player(username: str, latest_game_id: int):
    logger.verbose("Fetching games for username {} more recent than id {}".format(username, latest_game_id))
    url = "https://hanab.live/api/v1/history-full/{}?start={}".format(username, latest_game_id + 1)
    response = session.get(url)
    if not response.status_code == 200:
        err_msg = "Failed to fetch games for username {}, requested URL {}".format(username, url)
        logger.error(err_msg)
        raise ConnectionError(err_msg)
    return json.loads(response.text)


def process_game_entry(game_json: Dict, username_dict: Dict, variant_ids: List[int]) -> Optional[GameInfo]:
    logger.debug("Processing entry {}".format(game_json))
    config = config_manager.get_config()

    # Parse game properties
    game_id = game_json["id"]
    players = game_json["playerNames"]
    num_players = len(players)
    seed = game_json["seed"]
    score = game_json["score"]
    num_turns = game_json["numTurns"]
    start_time = game_json["datetimeStarted"]
    end_time = game_json["datetimeFinished"]

    game_options = game_json["options"]
    var_id = game_options["variantID"]

    normalized_usernames = [utils.normalize_username(username) for username in players]

    # Now, check if the game is one that we accept for league

    if not all([
            utils.are_game_options_allowed(game_id, game_options),
            utils.is_player_count_allowed(game_id, num_players),
            utils.is_game_id_allowed(game_id),
            utils.is_time_allowed(game_id, start_time)
        ]):
        return

    if var_id not in variant_ids:
        logger.debug("Rejected game {} due to invalid variant id {}".format(game_id, var_id))
        return

    # Everything matches, so we can parse the participants now
    user_ids = []  # This will be a list of the (league specific) user_id's that played this game.
    for normalized_username in normalized_usernames:
        user_id = username_dict.get(normalized_username, None)
        if user_id is None:
            logger.debug("Rejected game {} due to unregistered participant {}".format(game_id, normalized_username))
            return
        user_ids.append(user_id)

    return GameInfo(game_id, num_players, var_id, seed, score, num_turns, user_ids, normalized_usernames, start_time, end_time)


def fetch_games_for_all_players():
    logger.info("Fetching new games.")
    cur = conn_manager.get_new_cursor()
    cur.execute("SELECT user_accounts.normalized_username, user_accounts.user_id, downloads.latest_game_id "
                "FROM user_accounts "
                "LEFT OUTER JOIN downloads "
                "  ON user_accounts.normalized_username = downloads.normalized_username"
                )
    # This will be a mapping of normalized username -> user ID that we built from the DB data
    username_dict = {}

    # This will be a mapping of game id -> JSON data that we get from hanab.live, where we will collect all the
    # possibly relevant games now
    games: Dict[int, Dict] = {}
    for username, user_id, latest_game_id in cur.fetchall():
        username_dict[username] = user_id
        # Use the starting id as fallback if we have not downloaded any games for this player yet.
        if latest_game_id is None:
            latest_game_id = config_manager.get_config().starting_game_id

        player_games = fetch_games_for_player(username, latest_game_id)
        for game in player_games:
            games[game['id']] = game

    logger.info("Found {} potential league game(s) to process.".format(len(games)))

    allowed_variants = database.get_variant_ids()

    # This will hold the processed games that we will add to the database.
    good_games: Dict[int, GameInfo] = {}

    for game_id, game in games.items():
        game_info = process_game_entry(game, username_dict, allowed_variants)
        if game_info is not None:
            good_games[game_id] = game_info

    logger.verbose("Found {} valid league game(s).".format(len(good_games)))
    return good_games


def store_new_games(games: Dict[int, GameInfo]):
    conn = conn_manager.get_connection()
    cur = conn.cursor()
    games_vals = []
    game_participants_vals = []
    latest_game_ids: Dict[str, int] = {}

    # Now, iterate over all games and convert to tuples for insertion
    for game in sorted(games.values(), key=lambda game_info: game_info.game_id):
        tup = (game.game_id, game.num_players, game.variant_id, game.seed, game.score, game.num_turns, game.datetime_started, game.datetime_ended)
        games_vals.append(tup)
        for player_id in game.user_ids:
            tup = (game.game_id, player_id)
            game_participants_vals.append(tup)

        # Note that this gives the maximum in the end since we process the games in order
        for normalized_username in game.normalized_usernames:
            latest_game_ids[normalized_username] = game.game_id

    # Do the insertions
    # Notice that on conflict we can just do nothing: In that case, we already have the game in the DB for some reason
    # (for example, because we forced a download refresh)
    psycopg2.extras.execute_values(
        cur,
        "INSERT INTO games (id, num_players, variant_id, seed, score, num_turns, datetime_started, datetime_finished) "
        "VALUES %s "
        "ON CONFLICT (id) DO NOTHING",
        games_vals
    )
    psycopg2.extras.execute_values(
        cur,
        "INSERT INTO game_participants (game_id, user_id) "
        "VALUES %s "
        "ON CONFLICT (game_id, user_id) DO NOTHING",
        game_participants_vals
    )
    # Here, we want to update on insertion conflict
    psycopg2.extras.execute_values(
        cur,
        "INSERT INTO downloads (normalized_username, latest_game_id) "
        "VALUES %s "
        "ON CONFLICT (normalized_username) "
        "DO UPDATE SET (normalized_username, latest_game_id) = (EXCLUDED.normalized_username, EXCLUDED.latest_game_id)",
        latest_game_ids.items()
    )
    logger.info("Added {} game(s) to database.".format(len(games)))
    # We only commit after performing all insertions. This guarantees that the download table is always in sync
    # with the actual games stored in the database.
    conn.commit()


def detailed_fetch_game(game_id: int) -> bool:
    """
    Fetches full game details from the server and stores it in local DB if this game is a league game.
    @warning: Game data has to be present in database already, game details will then be added.
    @param game_id: Game ID from hanab.live
    @return: Whether the processed game was accepted as a league game, i.e. inserted into the DB
    """
    logger.verbose("Fetching details on game {}.".format(game_id))
    url = "https://hanab.live/export/{}".format(game_id)
    response = session.get(url)
    if not response.status_code == 200:
        err_msg = "Failed to fetch game {}, requested URL {}".format(game_id, url)
        logger.error(err_msg)
        raise ConnectionError(err_msg)
    game_json = json.loads(response.text)

    instance, actions = hanabi.live.hanab_live.parse_json_game(game_json, False)

    game_id = game_json["id"]
    players = game_json["players"]
    num_players = len(players)
    seed = game_json["seed"]
    game_options = game_json.get("options", {})
    var_name = game_options.get("variant", "No Variant")

    if not utils.are_game_options_allowed(game_id, game_options):
        return False

    if not utils.is_player_count_allowed(game_id, num_players):
        return False

    if not utils.is_game_id_allowed(game_id):
        return False

    var_id = database.get_variant_id(var_name)
    if var_id is None:
        logger.debug("Rejected game {} due to invalid variant id {}".format(game_id, var_id))
        return False

    # All game options are ok, now check if the number of players is okay.
    normalized_usernames = [utils.normalize_username(username) for username in players]
    user_ids = database.get_user_ids_from_normalized_usernames(normalized_usernames)
    # The return value here is a str if there was an unregistered participant
    if type(user_ids) is str:
        logger.debug("Rejected game {} due to unregistered participant {}".format(game_id, user_ids))
        return False

    # Now, we can start to actually process the game details
    instance, actions = hanabi.live.hanab_live.parse_json_game(game_json, False)
    game = hanabi.hanab_game.GameState(instance)
    # In order to figure out the score, we will need to play the game once
    for action in actions:
        game.make_action(action)

    conn = conn_manager.get_connection()
    cur = conn_manager.get_new_cursor()
    # Note that we assume the game is present in the database already


    game_participants_vals = []
    for seat, user_id in enumerate(user_ids):
        tup = (game_id, user_id, seat)
        game_participants_vals.append(tup)

    # This inserts the game participants now.
    # Note that the participants might already be stored, but not their seat (since we do not know the seat when only
    # getting a game list from the server on fetching the games played by some player)
    psycopg2.extras.execute_values(
        cur,
        "INSERT INTO game_participants "
        "(game_id, user_id, seat) "
        "VALUES %s "
        "ON CONFLICT (game_id, user_id) DO UPDATE "
        "SET seat = EXCLUDED.seat",
        game_participants_vals
    )
    # DB is now in a consistent state again: We made sure the game and its participants are added.
    conn.commit()

    # It remains to store the seed and action data for this game
    # Note that we store the seed first. This ensures that whenever we have actions stored, we also have the seed stored.
    games_db_interface.store_deck_for_seed(seed, instance.deck)
    games_db_interface.store_actions(game_id, actions)
    logger.debug("Fetched all game details of game {}.".format(game_id))

    # Do some sanity checks that loading the stored data did not change it
    assert actions == games_db_interface.load_actions(game_id)
    assert instance.deck == games_db_interface.load_deck(seed)
    return True


def fetch_all_game_details():
    logger.info("Fetching detailed game data for all games.")
    cur = conn_manager.get_new_cursor()

    # Get all games with no actions
    cur.execute("SELECT id FROM games "
                "LEFT OUTER JOIN game_actions"
                "  ON games.id = game_actions.game_id "
                "WHERE game_actions.game_id IS NULL"
                )
    for (game_id,) in cur.fetchall():
        detailed_fetch_game(game_id)

    # Just to make sure, check that we have data on all seeds
    cur.execute("SELECT id FROM games "
                "LEFT OUTER JOIN seeds"
                "  ON seeds.seed = games.seed "
                "WHERE seeds.seed IS NULL"
                )
    games_without_seeds = [game_id for (game_id,) in cur.fetchall()]
    if len(games_without_seeds) != 0:
        logger.warn("Detected the following games without seed data, but with actions already stored: {}."
                    "Fetching them now".format(", ".join(games_without_seeds))
                    )
        for game_id in games_without_seeds:
            detailed_fetch_game(game_id)