Skip to content

ikorepanov/hangman

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

126 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hangman

Небольшое консольное приложение на Python, реализующее классическую словесную игру с пошаговым взаимодействием пользователя и текстовой визуализацией состояния игрового процесса.


О проекте

Проект представляет собой реализацию интерактивного консольного приложения, в котором пользователь взаимодействует с программой через последовательный ввод символов. Основной фокус сделан на управлении состоянием приложения, обработке пользовательского ввода и организации игрового цикла.

Проект не использует графический интерфейс и полностью работает в терминале.


Игровая логика

В рамках одного раунда приложение загадывает слово из заранее подготовленного набора и постепенно раскрывает его по мере ввода символов пользователем. Программа отслеживает текущее состояние попытки, отображает прогресс в текстовом виде и реагирует на некорректный или повторяющийся ввод.

Раунд завершается при достижении одного из граничных условий, после чего приложение возвращается в начальное состояние и ожидает дальнейших действий пользователя.


Особенности реализации

  • пошаговая обработка пользовательского ввода;
  • валидация вводимых символов;
  • хранение и отображение текущего состояния слова;
  • текстовая визуализация прогресса;
  • управление выводом в терминале с использованием ANSI escape sequences;
  • изолированная логика игровых раундов без использования рекурсии.

Используемые технологии

  • Python 3.9+
  • терминальный ввод / вывод
  • ANSI escape sequences

Установка

Клонируйте репозиторий:

git clone https://github.com/ikorepanov/hangman.git

Перейдите в папку проекта:

cd hangman

Создайте виртуальное окружение:

python -m venv .venv

Активируйте виртуальное окружение:

  • Linux / macOS
    source .venv/bin/activate
  • Windows
    .venv\Scripts\activate

Обновите pip:

python -m pip install --upgrade pip

Установите проект:

pip install .

Запуск

Для запуска приложения выполните:

python -m hangman.main

Дальнейшие действия подсказываются непосредственно в интерфейсе программы.


Конфигурация

Приложение использует внешний файл с набором слов, формат которого позволяет при необходимости заменить источник данных без изменения логики программы. Это упрощает эксперименты с различными наборами входных данных.


Скриншоты

Стартовый экран

start

Процесс игры

beginning

Завершение раунда

win

lost

Сообщения и предупреждения

warn

Выход из приложения

bye


Статус проекта

Проект завершён и предназначен для демонстрации подхода к реализации консольных приложений на Python с минимальным набором зависимостей.

About

Console Hangman game with ASCII graphics, input validation, and terminal cursor control

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages