Function askForPlayerMove

src/gamesbyexample/ultimatetictactoe.py:168–207

Asks the player which space on which small board to move on. The focusX and focusY values determine which small board the player can move on, but if they are both None the player can freely choose a small board. Returns the (x, y) of the small board the next player plays on.

(player, board, focusX, focusY)

def askForPlayerMove(player, board, focusX, focusY):
    """Asks the player which space on which small board to move on.
    The focusX and focusY values determine which small board the player
    can move on, but if they are both None the player can freely choose
    a small board. Returns the (x, y) of the small board the next player
    plays on.
    """
    # Check if the player can freely select any small board:
    if focusX is None and focusY is None:
        # Let the player pick which board they want to move on:
        print(player + ': Enter the BOARD you want to move on.')
        validBoardsToSelect = []
        for xyTuple, smallBoard in board.items():
            if getWinner(smallBoard) is None:
                validBoardsToSelect.append(xyTuple)
        selectedBoard = enter1Through9(validBoardsToSelect)
        focusX = selectedBoard % 3
        focusY = selectedBoard // 3

    # Select the space on the focused small board:
    smallXDesc = ['left', 'middle', 'right'][focusX]
    smallYDesc = ['top', 'middle', 'bottom'][focusY]
    print(player, 'moves on the', smallYDesc, smallXDesc, 'board.')
    validSpacesToSelect = []
    for xyTuple, tile in board[(focusX, focusY)].items():
        if tile == EMPTY_SPACE:
            validSpacesToSelect.append(xyTuple)
    selectedSpace = enter1Through9(validSpacesToSelect)
    x = selectedSpace % 3
    y = selectedSpace // 3

    board[(focusX, focusY)][(x, y)] = player

    # Figure out the small board that the next player must move on:
    if getWinner(board[x, y]) is None:
        return (x, y)
    else:
        # If the small board has a winner or is tied, the next player
        # can move on any small board:
        return (None, None)


def enter1Through9(validMoves):