example.py

#!/usr/bin/env python3

from engine.structures import Card, Rank, Suit
from engine.game import Game
from engine.players import Human, RandomAgent, SimpleGreedyAgent

# Player-change callback hook
def player_change_callback(new_player):
    print("Callback called, new player: ", new_player)

# User input retrieval handler
def human_input_handler():
    i = input("Pick a card (1-3): ")
    return int(i) - 1

# Instantiating players
player1 = RandomAgent("Player 1")
player2 = SimpleGreedyAgent("Player 2")
player3 = Human("Player 3")
player3.register_input_handler(human_input_handler)

# Instantiating game
game = Game()

# Adding players to the game
game.add_player(player1)
game.add_player(player2)
game.add_player(player3)

# Example of registering a callback hook (optional)
game.player_pool.register_callback(player_change_callback)

# Starting match
game.start_match()

# Playing the game
while not game.is_over():
	game.next_round()

print("Game over! The winner is: ", game.get_winner())