feat: start add schemas support

Author: alexeev-prog

CHANGELOG.md

@@ -1,3 +1,9 @@
+commit 6c22c1440b0454a8295c637fe1d07d7848d198c8
+Author: Alexeev Bronislav <[email protected]>
+Date:   Sat May 3 13:11:31 2025 +0700
+
+    fix: fix bugs, docstrings
+
 commit 8e25c30dcb41d13a213c0e40904f76d0dc015bb2
 Author: Alexeev Bronislav <[email protected]>
 Date:   Sat May 3 00:26:30 2025 +0700

README.md

@@ -59,7 +59,7 @@ Welcome to **EchoNext**, where innovation meets simplicity! Are you tired of the
 
 **Imagine** a lightweight framework that empowers you to create modern web applications with lightning speed and flexibility. With EchoNext, you're not just coding; you're building a masterpiece!
 
- > Last stable version: 0.7.16 alpha
+ > Last stable version: 0.7.17 alpha
 
  > Next Big Update: ASYNC & unicorn support
 
@@ -117,6 +117,7 @@ Welcome to **EchoNext**, where innovation meets simplicity! Are you tired of the
  + performance
  + slugger
  + permissions
+ + pyEchoNext Schemas (`pyechonext.schemas`) and pydantic support for validating schemas
 
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 

SECURITY.md

@@ -7,6 +7,7 @@ currently being supported with security updates.
 
 | Version | Supported          |
 |---------| ------------------ |
+| 0.7.17  | :white_check_mark: |
 | 0.7.16  | :white_check_mark: |
 | 0.7.15  | :white_check_mark: |
 | 0.7.14  | :white_check_mark: |

docs/conf.py

@@ -9,7 +9,7 @@
 
 project = "pyEchoNext"
 author = "name"
-version = "0.7.16"
+version = "0.7.17"
 release = "0.7"
 project_copyright = "2025, Alexeev Bronislaw"
 

pyechonext/__init__.py

@@ -22,7 +22,7 @@
 from rich import print
 from rich.traceback import install
 
-__version__ = "0.7.15"
+__version__ = "0.7.17"
 install(show_locals=True)
 
 

pyechonext/schemas/__init__.py

@@ -1,10 +0,0 @@
-from functools import wraps
-
-
-def field_validation(handler, cls, value):
-    @wraps(handler)
-    def wrapper():
-        result = handler(cls, value)
-        return result
-
-    return wrapper

pyechonext/schemas/fields.py

@@ -0,0 +1,88 @@
+# дай угадаю, кто то украл твой сладкий рулет?
+from typing import Any, Optional, Dict, Optional, Callable, Union, Type, List
+
+
+class BaseField:
+    """This class describes the Base Field.
+
+    Field is a one input data. Field must be have a:
+    1. Datatype - any Type
+    2. Default value (only if this field is optional)
+    3. max_length - max length of value for field
+    4. desc - description text of field
+    5. exclude - exclude this field from model json
+    6. transformer - a transformer (convert value datatype) callable object
+    7. dependencies - fields-dependencies
+    8. name - name of field
+    """
+
+    def __init__(self,
+                 name: str,
+                 datatype: Type,
+                 nullable: bool = False,
+                 default: Optional[Any] = None,
+                 max_length: Optional[int] = None,
+                 desc: Optional[str] = None,
+                 exclude: bool = False,
+                 transformer: Optional[Callable[[Any], Any]] = None,
+                 dependencies: Optional[List[str]] = None) -> None:
+        self.name = name
+        self.nullable = nullable
+        self.datatype: Type = datatype
+        self.default: Any | None = default
+        self.max_length: int | None = max_length
+        self.desc: str | None = desc
+        self.exclude: bool = exclude
+        self.transformer: Callable[[Any], Any] | None = transformer
+        self.dependencies: List[str] | None = dependencies
+
+    def fast_validate(self, value: Any) -> bool:
+        """Fast validation of field value
+
+        Args:
+            value (Any): value of field.
+
+        Returns:
+            bool: True if all conditions is right, otherwise False
+        """
+        conditions = [
+            isinstance(value, self.datatype),
+            len(value) <= max_length
+        ]
+
+        return all(conditions)
+    
+    def validate(self,
+                 value: Any,
+                 context: Optional[Dict[str, Any]] = None) -> Any:
+        """Validate field value
+
+        Args:
+            value (Any): value for validating
+            context (Dict[str, Any]): context with data for validate dependenc fields. Defaults to None.
+
+        Raises:
+            ValueError: is field is None (and not nullable) or field have invalid dependencies
+
+        Returns:
+            Any: validated and transformed value
+        """
+        if value is None and self.default is None and not nullable:
+            raise ValueError(f'Field "{self.name}" is required and must not be none')
+
+        if not isinstance(value, self.datatype):
+            value = self._type_case(value)
+
+        self._check_type(value)
+        self._check_length(value)
+
+        if self.transformer:
+            value = self.transformer(value)
+
+        if context:
+            for dependency in self.dependencies:
+                if dependency in context and not self._validate_dependency(value, context[dependency]):
+                    raise ValueError(f"Field '{self.name}' is invalid based on dependency {dependency}.")
+
+        return value
+