haive.games.hold_em.example
===========================

.. py:module:: haive.games.hold_em.example

.. autoapi-nested-parse::

   Example usage of the Texas Hold'em poker implementation.

   This example script demonstrates how to:
       - Create and configure a Texas Hold'em game
       - Set up player agents with different playing styles
       - Run a complete game with the Rich UI
       - Access and analyze game results

   Run this script directly to see a Hold'em game in action.



Functions
---------

.. autoapisummary::

   haive.games.hold_em.example.analyze_game_results
   haive.games.hold_em.example.create_custom_game
   haive.games.hold_em.example.main
   haive.games.hold_em.example.run_example_game


Module Contents
---------------

.. py:function:: analyze_game_results(agent)

   Analyze the results of a completed game.

   :param agent: The game agent after running a game


.. py:function:: create_custom_game(player_names, player_styles = None, starting_chips = 1000, small_blind = 10, big_blind = 20, max_hands = 50)

   Create a custom Hold'em game with specified players and settings.

   :param player_names: List of player names
   :param player_styles: Optional list of player styles (defaults to "balanced" for all)
   :param starting_chips: Starting chips per player
   :param small_blind: Small blind amount
   :param big_blind: Big blind amount
   :param max_hands: Maximum hands to play

   :returns: Configured game agent ready to run
   :rtype: HoldemGameAgent


.. py:function:: main()

   Main entry point with command line argument handling.


.. py:function:: run_example_game(game_type = 'default', delay = 1.5)

   Run an example Hold'em game with the specified configuration.

   :param game_type: Type of game to run ("default", "heads-up", "tournament", "cash", "custom")
   :param delay: Delay between UI updates (seconds)