Python Hangman Game Project

"""A small, dependency-free command-line Hangman game."""

from __future__ import annotations

import secrets
import string


WORDS = (
    "algorithm",
    "function",
    "iterator",
    "variable",
    "terminal",
    "database",
    "python",
    "software",
)
MAX_WRONG_GUESSES = 6


def masked_word(word: str, guessed: set[str]) -> str:
    """Return a spaced display that reveals only guessed letters."""
    return " ".join(letter if letter in guessed else "_" for letter in word)


def read_guess(guessed: set[str]) -> str:
    """Read one new English letter from the player."""
    while True:
        guess = input("Guess one letter: ").strip().lower()
        if len(guess) != 1 or guess not in string.ascii_lowercase:
            print("Enter exactly one letter from A to Z.")
        elif guess in guessed:
            print("You already tried that letter.")
        else:
            return guess


def play(word: str | None = None) -> bool:
    """Play one game and return True when the player wins."""
    secret_word = (word or secrets.choice(WORDS)).lower()
    if not secret_word.isascii() or not secret_word.isalpha():
        raise ValueError("The secret word must contain only A-Z letters.")

    guessed: set[str] = set()
    wrong_guesses = 0

    print("\nPython Hangman")
    print(f"The word has {len(secret_word)} letters.")

    while wrong_guesses < MAX_WRONG_GUESSES:
        print(f"\nWord: {masked_word(secret_word, guessed)}")
        print(f"Wrong guesses remaining: {MAX_WRONG_GUESSES - wrong_guesses}")
        if guessed:
            print("Tried:", " ".join(sorted(guessed)))

        guess = read_guess(guessed)
        guessed.add(guess)

        if guess not in secret_word:
            wrong_guesses += 1
            print("That letter is not in the word.")

        if set(secret_word) <= guessed:
            print(f"\nYou won! The word was {secret_word}.")
            return True

    print(f"\nGame over. The word was {secret_word}.")
    return False


def main() -> None:
    while True:
        play()
        again = input("Play again? [y/N]: ").strip().lower()
        if again != "y":
            print("Thanks for playing.")
            break


if __name__ == "__main__":
    main()