docs/feat: add models and views in MVC

Author: alexeev-prog

docs/en/index.md

@@ -8,6 +8,7 @@
 4. [Request/Response](./requests_responses.md)
 5. [i18n](./i18n_locales.md)
 6. [Security](./security.md)
+7. [MVC](./mvc.md)
 
 ## Additional materials
 

docs/en/mvc.md

@@ -0,0 +1,17 @@
+# pyEchoNext / MVC Architecture
+
+---
+
+MVC stands for Model-View-Controller, an architectural pattern that divides an application into three logical components: the model, the View, and the controller.
+
+The main idea of the MVC pattern is that each section of code has its own purpose. Part of the code contains application data, the other is responsible for how the user sees it, the latter controls its operation.
+
++ Model code **Model** stores data and associated logic, and anchors the structure of the application. That is, the programmer will determine the main components of the application using the template.
++ The application's appearance code, **View**, consists of functions that are responsible for the interface and how the user interacts with it. Views are created based on data collected from the model.
++ The controller code, **Controller**, links the model and view. It receives user input, interprets it and informs about the necessary changes. For example, sends commands to update state, such as saving a document.
+
+---
+
+[Contents](./index.md)
+
+

docs/ru/index.md

@@ -8,6 +8,7 @@
 4. [Request/Response](./requests_responses.md)
 5. [i18n](./i18n_locales.md)
 6. [Безопасность](./security.md)
+7. [MVC](./mvc.md)
 
 ## Дополнительные материалы
 

docs/ru/mvc.md

@@ -0,0 +1,17 @@
+# pyEchoNext / MVC Architecture
+
+---
+
+MVC - Model-View-Controller, архитектурный паттерн, который разделяет приложение на три логических компонента: модель, View (представление) и контроллер.
+
+Основная идея паттерна MVC в том, что у каждого раздела кода есть своя цель. Часть кода содержит данные приложения, друга отвечает за то, каким видит его пользователь, последняя управлеяет его работой.
+
+ + Код модели **Model** хранит данные и связанную с ними логику, а также закрепляет структуру приложения. То есть программист по шаблону будет определять основные компоненты приложения.
+ + Код внешнего вида приложения, **View**, состоит из функций, которые отвечают за интерфейс и способы взаимодействия пользователя с ним. Представления создают на основе данных, собранных из модели.
+ + Код контроллера, **Controller**, связывает модель и представление. Он получает на вход пользовательский ввод, интепретирует его и информирует о необходимых изменениях. Например, отправляет команды для обновления состояния, таких как сохранение документа.
+
+---
+
+[Содержание](./index.md)
+
+

pyechonext/mvc/controllers.py

@@ -0,0 +1 @@
+# TODO: make controllers

pyechonext/mvc/models.py

@@ -1,6 +1,86 @@
-from abc import ABC, abstractmethod
 from typing import Any, Union
+from abc import ABC, abstractmethod
+from pyechonext.request import Request
+from pyechonext.response import Response
+
+
+class BaseModel(ABC):
+	"""
+	This class describes a base model.
+	"""
+
+	@abstractmethod
+	def create_response(self, *args, **kwargs) -> Response:
+		"""
+		Creates a response.
+
+		:param      args:    The arguments
+		:type       args:    list
+		:param      kwargs:  The keywords arguments
+		:type       kwargs:  dictionary
+
+		:returns:   response object
+		:rtype:     Response
+		"""
+		raise NotImplementedError
+
+	@abstractmethod
+	def create_request(self, *args, **kwargs) -> Request:
+		"""
+		Creates a request.
+
+		:param      args:    The arguments
+		:type       args:    list
+		:param      kwargs:  The keywords arguments
+		:type       kwargs:  dictionary
+
+		:returns:   request object
+		:rtype:     Request
+		"""
+		raise NotImplementedError
+
+
+class PageModel(BaseView):
+	"""
+	This class describes a page model.
+	"""
+
+	def __init__(self, request: Request, response: Response):
+		"""
+		Constructs a new instance.
+
+		:param      request:   The request
+		:type       request:   Request
+		:param      response:  The response
+		:type       response:  Response
+		"""
+		self.request = request
+		self.response = response
+
+	def create_response(self, *args, **kwargs) -> Response:
+		"""
+		Creates a response.
+
+		:param      args:    The arguments
+		:type       args:    list
+		:param      kwargs:  The keywords arguments
+		:type       kwargs:  dictionary
+
+		:returns:   response object
+		:rtype:     Response
+		"""
+		return Response(*args, **kwargs)
+
+	def create_request(self, *args, **kwargs) -> Request:
+		"""
+		Creates a request.
 
+		:param      args:    The arguments
+		:type       args:    list
+		:param      kwargs:  The keywords arguments
+		:type       kwargs:  dictionary
 
-class BaseView(ABC):
-	def __init__(self)
+		:returns:   request object
+		:rtype:     Request
+		"""
+		return Request(*args, **kwargs)

pyechonext/mvc/views.py

@@ -0,0 +1,28 @@
+from abc import ABC, abstractmethod
+from typing import Union, Any, Optional
+from pyechonext.response import Response
+from pyechonext.request import Request
+from pyechonext.i18n_l10n import JSONi18nLoader
+
+
+class BaseView(ABC):
+	@abstractmethod
+	def render(self, request: Request, response: Response, *args, **kwargs):
+		raise NotImplementedError
+
+
+class i18nView(BaseView):
+	def render(self, data: str, i18n_loader: JSONi18nLoader, **kwargs):
+		return i18n_loader.get_string(data, **kwargs)
+
+
+class PageView(BaseView):
+	def render(self, data: Union[Response, Any], *args, **kwargs):
+		if self.use_i18n:
+			data = self.i18n_loader.get_string(data)
+
+		if isinstance(data, Response):
+			return data
+		else:
+			response = Response(body=str(data), *args, **kwargs)
+			return response