🏠 Домашнее задание

📋 Формулировка задания

🔧 Шаг 0. Подготовка окружения

Перед началом работы над любым заданием курса нужно настроить окружение. Эти шаги одинаковы для всех уроков.

# Или в терминале VS Code (Ctrl + `):
mkdir python-fundamentals-practice
cd python-fundamentals-practice

git init

echo "# Python Fundamentals — Практические работы" > README.md
echo "venv/" > .gitignore
echo "__pycache__/" >> .gitignore
echo "*.pyc" >> .gitignore
echo ".env" >> .gitignore

git add README.md .gitignore
git commit -m "init: базовая структура репозитория"

mkdir -p lesson-77
cd lesson-77

# Windows
python -m venv venv
venv\Scripts\activate

# Mac / Linux
python3 -m venv venv
source venv/bin/activate

cd ..
git checkout -b lesson/77-door-code

🛠️ Шаги выполнения задания

Теперь, когда окружение готово, приступайте к решению.

# В терминале с активированным venv
python lesson-77/door.py

Access denied.
Access denied. Code not changed.
Too many failed attempts.
Door is blocked. Try again in 0 min 1 sec.
Access granted.

✅ Полное решение

Ниже приведено полное решение задания. Совет: попробуйте выполнить самостоятельно, прежде чем смотреть ответ.

import time
from datetime import datetime, timedelta


class DoorBlockedError(Exception):
    '''Raised when trying to access a blocked door.'''
    pass


class Door:
    def __init__(self, code: str, max_attempts: int = 3, block_minutes: float = 15.0) -> None:
        self.__code = code
        self.__failed_attempts = 0
        self.__max_attempts = max_attempts
        self.__block_duration = timedelta(minutes=block_minutes)
        self.__block_until = None

    def unlock(self, code: str) -> bool:
        if self.__is_blocked():
            raise DoorBlockedError(self.__remaining_block_time())

        if self.__is_valid_code(code):
            print("Access granted.")
            self.__reset_attempts()
            return True

        print("Access denied.")
        self.__handle_failed_attempt()
        return False

    def change_code(self, old_code: str, new_code: str) -> None:
        if self.__is_blocked():
            raise DoorBlockedError(self.__remaining_block_time())

        if self.__is_valid_code(old_code):
            self.__code = new_code
            self.__reset_attempts()
            print("Code changed.")
            return

        print("Access denied. Code not changed.")
        self.__handle_failed_attempt()

    def __is_valid_code(self, code: str) -> bool:
        return code == self.__code

    def __is_blocked(self) -> bool:
        if self.__block_until is None:
            return False
        return datetime.now() < self.__block_until

    def __remaining_block_time(self) -> str:
        remaining = self.__block_until - datetime.now()
        seconds = int(remaining.total_seconds())
        minutes, sec = divmod(seconds, 60)
        return f"Door is blocked. Try again in {minutes} min {sec} sec."

    def __check_block(self) -> None:
        if self.__failed_attempts >= self.__max_attempts:
            self.__block_until = datetime.now() + self.__block_duration
            print("Too many failed attempts.")

    def __handle_failed_attempt(self) -> None:
        self.__failed_attempts += 1
        self.__check_block()

    def __reset_attempts(self) -> None:
        self.__failed_attempts = 0


if __name__ == "__main__":
    door = Door("1234", max_attempts=2, block_minutes=0.03)

    attempts = [
        lambda: door.unlock("1111"),
        lambda: door.change_code("0000", "9999"),
        lambda: door.unlock("1234"),
    ]

    for action in attempts:
        try:
            action()
        except DoorBlockedError as e:
            print(e)

    time.sleep(2)

    try:
        door.unlock("1234")
    except DoorBlockedError as e:
        print(e)

🧪 Как проверить решение

🐛 Отладка в VS Code

Если что-то не работает:

1. Поставьте точку останова (breakpoint) кликом слева от номера строки, например на строке if self.__is_blocked():.
2. Нажмите F5 или выберите «Run → Start Debugging».
3. Используйте панель Debug: проверьте значения __failed_attempts и __block_until.
4. Посмотрите Terminal — Python покажет номер строки с ошибкой и traceback.

💾 Сохранение работы

git add lesson-77/
git commit -m "lesson-77: электронная дверь с кодом и пользовательским исключением"
git push

💡 Советы и типичные ошибки

• Не забудьте сбросить __failed_attempts после успешного unlock или change_code.
• Проверяйте блокировку в начале каждого публичного метода — это guard clause.
• Используйте datetime и timedelta, а не «сырые» секунды.
• Не коммитьте папку venv/ — она указана в .gitignore.