haive.games.hold_em.config
==========================

.. py:module:: haive.games.hold_em.config

.. autoapi-nested-parse::

   Texas Hold'em configuration module.

   This module provides configuration classes for the Hold'em game, including:
       - Game agent configuration
       - Player agent configurations
       - Engine configurations



Classes
-------

.. autoapisummary::

   haive.games.hold_em.config.HoldemGameSettings


Functions
---------

.. autoapisummary::

   haive.games.hold_em.config.create_cash_game_config
   haive.games.hold_em.config.create_custom_holdem_config
   haive.games.hold_em.config.create_default_holdem_config
   haive.games.hold_em.config.create_fallback_engines
   haive.games.hold_em.config.create_fallback_game_engines
   haive.games.hold_em.config.create_heads_up_config
   haive.games.hold_em.config.create_tournament_config
   haive.games.hold_em.config.validate_config
   haive.games.hold_em.config.validate_player_engines


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

.. py:class:: HoldemGameSettings(/, **data)

   Bases: :py:obj:`pydantic.BaseModel`


   Settings for customizing Hold'em games.

   Create a new model by parsing and validating input data from keyword arguments.

   Raises [`ValidationError`][pydantic_core.ValidationError] if the input data cannot be
   validated to form a valid model.

   `self` is explicitly positional-only to allow `self` as a field name.


   .. py:method:: to_game_config()

      Convert settings to a game configuration.



.. py:function:: create_cash_game_config(num_players = 6, big_blind = 20, max_buy_in = 2000, min_buy_in = 400)

   Create a cash game configuration.


.. py:function:: create_custom_holdem_config(settings)

   Create a custom Hold'em configuration from settings.


.. py:function:: create_default_holdem_config(num_players = 4, starting_chips = 1000, small_blind = 10, big_blind = 20)

   Create a default Hold'em game configuration.


.. py:function:: create_fallback_engines(player_name, player_style)

   Create minimal fallback engines if the main engine creation fails.


.. py:function:: create_fallback_game_engines()

   Create minimal fallback game engines.


.. py:function:: create_heads_up_config(player1_name = 'Alice', player2_name = 'Bob', starting_chips = 1000, big_blind = 20)

   Create a heads-up (2 player) configuration.


.. py:function:: create_tournament_config(num_players = 6, starting_chips = 1500, blind_levels = None)

   Create a tournament-style configuration with escalating blinds.


.. py:function:: validate_config(config)

   Validate a game configuration and return issues found.


.. py:function:: validate_player_engines(engines)

   Validate that player engines are properly configured.