Method __init__

codeclash/arenas/arena.py:78–108

The CodeArena class is responsible for running games, i.e., taking a list of code from different agents/players and running them against each other. It also provides the environments for the game and agents to run in. The central method is `run_round`, which takes a list of

(self, config: dict, *, tournament_id: str, local_output_dir: Path, keep_containers: bool = False)

    default_args: dict = {}
    submission: str

    # Serializes image builds across concurrent pairs (e.g. `ladder make --workers N`), so
    # worker threads don't all race `docker build` on a cold start and fail with "already exists".
    _build_lock = threading.Lock()

    def __init__(self, config: dict, *, tournament_id: str, local_output_dir: Path, keep_containers: bool = False):
        """The CodeArena class is responsible for running games, i.e., taking a list of code
        from different agents/players and running them against each other.
        It also provides the environments for the game and agents to run in.

        The central method is `run_round`, which takes a list of agents and returns the winner of the round.

        At the end of the the tournament, run the `end` method to clean up the game and agents and write the metadata.

        Args:
            config: The overall config for the tournament.
            tournament_id: The id of the tournament.
            local_output_dir: The host/local directory to write logs to.
            keep_containers: Do not remove containers after games/agent finish.
        """
        self.url_gh: str = f"git@github.com:{GH_ORG}/{self.name}.git"
        self.artifacts: list[Path] = []
        """Artifact objects that we might want to clean up after the game."""
        self.config: dict = config
        self._keep_containers: bool = keep_containers
        self._metadata: dict = {
            "name": self.name,
            "config": self.config["game"],
            "game_id": tournament_id,
            "created_timestamp": int(time.time()),
        }
        self.log_env: Path = DIR_LOGS
        self.log_local: Path = local_output_dir
        self.logger = get_logger(self.name, log_path=self.log_local / "game.log", emoji="🏓")