From 67f980d162c1a836243fb8c84ec286383f9d538d Mon Sep 17 00:00:00 2001
From: proDream <sushkoos@gmail.com>
Date: Sat, 11 Jan 2025 02:30:26 +0400
Subject: [PATCH] =?UTF-8?q?feat:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB?=
 =?UTF-8?q?=D0=B5=D0=BD=D1=8B=20=D1=81=D1=85=D0=B5=D0=BC=D1=8B=20=D0=B4?=
 =?UTF-8?q?=D0=B0=D0=BD=D0=BD=D1=8B=D1=85=20=D0=B4=D0=BB=D1=8F=20=D0=B0?=
 =?UTF-8?q?=D0=B2=D1=82=D0=BE=D1=80=D0=B8=D0=B7=D0=B0=D1=86=D0=B8=D0=B8=20?=
 =?UTF-8?q?=D0=B2=20=D0=BF=D1=80=D0=B8=D0=BB=D0=BE=D0=B6=D0=B5=D0=BD=D0=B8?=
 =?UTF-8?q?=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Создан новый файл `schemas.py` в директории `lkeep/apps/auth`.
- Внутри файла определены несколько классов Pydantic для обработки различных сценариев работы с пользователями (получение по ID, электронной почте, регистрация и создание).
- Каждый класс имеет соответствующие поля и типы данных, а также документации в формате docstring.
- Добавлены комментарии к файлу для описания проекта, автора, года создания и специализации.
---
 lkeep/apps/auth/schemas.py | 79 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 lkeep/apps/auth/schemas.py

diff --git a/lkeep/apps/auth/schemas.py b/lkeep/apps/auth/schemas.py
new file mode 100644
index 0000000..cce7084
--- /dev/null
+++ b/lkeep/apps/auth/schemas.py
@@ -0,0 +1,79 @@
+"""
+Проект: Lkeep
+Автор: Иван Ашихмин
+Год: 2025
+Специально для проекта "Код на салфетке"
+https://pressanybutton.ru/category/servis-na-fastapi/
+"""
+
+import datetime
+import uuid
+
+from pydantic import BaseModel, EmailStr
+
+
+class GetUserByID(BaseModel):
+    """
+    Класс для получения пользователя по его уникальному идентификатору (ID).
+
+    :ivar id: Уникальный идентификатор пользователя, может быть представлен как объект типа uuid.UUID или строкой.
+    :type id: uuid.UUID | str
+    """
+
+    id: uuid.UUID | str
+
+
+class GetUserByEmail(BaseModel):
+    """
+    Класс для поиска пользователя по электронной почте.
+
+    :ivar email: Электронная почта пользователя.
+    :type email: EmailStr
+    """
+
+    email: EmailStr
+
+
+class RegisterUser(GetUserByEmail):
+    """
+    Класс для регистрации пользователя, наследующий класс GetUserByEmail.
+
+    :ivar password: Пароль пользователя.
+    :type password: str
+    """
+
+    password: str
+
+
+class CreateUser(GetUserByEmail):
+    """
+    Класс для создания пользователя.
+
+    :ivar hashed_password: Хэшированный пароль пользователя.
+    :type hashed_password: str
+    """
+
+    hashed_password: str
+
+
+class UserReturnData(GetUserByID, GetUserByEmail):
+    """
+    Класс для представления данных пользователя, возвращаемых из API.
+
+    :ivar is_active: Статус активности пользователя.
+    :type is_active: bool
+    :ivar is_verified: Статус верификации пользователя.
+    :type is_verified: bool
+    :ivar is_superuser: Флаг, указывающий на наличие привилегий суперпользователя.
+    :type is_superuser: bool
+    :ivar created_at: Временная метка создания записи о пользователе.
+    :type created_at: datetime.datetime
+    :ivar updated_at: Временная метка последнего обновления записи о пользователе.
+    :type updated_at: datetime.datetime
+    """
+
+    is_active: bool
+    is_verified: bool
+    is_superuser: bool
+    created_at: datetime.datetime
+    updated_at: datetime.datetime