amsdal 0.4.13__cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

amsdal/contrib/frontend_configs/models/frontend_config_validator.py

@@ -0,0 +1,28 @@
+from typing import Any
+from typing import ClassVar
+
+from amsdal_models.builder.validators.options_validators import validate_options
+from amsdal_utils.models.enums import ModuleType
+from pydantic.fields import Field
+from pydantic.functional_validators import field_validator
+
+from amsdal.contrib.frontend_configs.models.frontend_config_group_validator import *  # noqa: F403
+
+
+class FrontendConfigValidator(FrontendConfigGroupValidator):  # noqa: F405
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    mainControl: str | None = Field(None, title='Main Control')  # noqa: N815
+    dependentControls: list[str] | None = Field(None, title='Dependent Controls')  # noqa: N815
+    condition: str | None = Field(None, title='Condition')
+    function: str | None = Field(None, title='Function')
+    value: str | None = Field(None, title='Value')
+
+    @field_validator('condition')
+    @classmethod
+    def validate_value_in_options_condition(cls: type, value: Any) -> Any:
+        return validate_options(value, options=['eq', 'exist', 'gt', 'gte', 'lt', 'lte', 'neq'])
+
+    @field_validator('function')
+    @classmethod
+    def validate_value_in_options_function(cls: type, value: Any) -> Any:
+        return validate_options(value, options=['max', 'maxLength', 'min', 'minLength', 'pattern', 'required'])

amsdal/contrib/frontend_configs/models/frontend_config_validator.pyi

@@ -0,0 +1,15 @@
+from amsdal.contrib.frontend_configs.models.frontend_config_group_validator import *
+from amsdal_utils.models.enums import ModuleType
+from typing import Any, ClassVar
+
+class FrontendConfigValidator(FrontendConfigGroupValidator):
+    __module_type__: ClassVar[ModuleType]
+    mainControl: str | None
+    dependentControls: list[str] | None
+    condition: str | None
+    function: str | None
+    value: str | None
+    @classmethod
+    def validate_value_in_options_condition(cls, value: Any) -> Any: ...
+    @classmethod
+    def validate_value_in_options_function(cls, value: Any) -> Any: ...

amsdal/contrib/frontend_configs/models/frontend_control_config.py

@@ -0,0 +1,87 @@
+from typing import Any
+from typing import ClassVar
+from typing import Optional
+
+from amsdal_models.builder.validators.options_validators import validate_options
+from amsdal_utils.models.enums import ModuleType
+from pydantic.fields import Field
+from pydantic.functional_validators import field_validator
+
+from amsdal.contrib.frontend_configs.models.frontend_activator_config import *  # noqa: F403
+from amsdal.contrib.frontend_configs.models.frontend_config_async_validator import *  # noqa: F403
+from amsdal.contrib.frontend_configs.models.frontend_config_control_action import *  # noqa: F403
+from amsdal.contrib.frontend_configs.models.frontend_config_option import *  # noqa: F403
+from amsdal.contrib.frontend_configs.models.frontend_config_skip_none_base import *  # noqa: F403
+from amsdal.contrib.frontend_configs.models.frontend_config_slider_option import *  # noqa: F403
+from amsdal.contrib.frontend_configs.models.frontend_config_text_mask import *  # noqa: F403
+from amsdal.contrib.frontend_configs.models.frontend_config_validator import *  # noqa: F403
+
+
+class FrontendControlConfig(FrontendConfigSkipNoneBase):  # noqa: F405
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    type: str = Field(title='Type')
+    name: str = Field(title='Name')
+    label: str | None = Field(None, title='Label')
+    required: bool | None = Field(None, title='Required')
+    hideLabel: bool | None = Field(None, title='Hide Label')  # noqa: N815
+    actions: list['FrontendConfigControlAction'] | None = Field(None, title='Actions')  # noqa: F405
+    validators: list['FrontendConfigValidator'] | None = Field(None, title='Validators')  # noqa: F405
+    asyncValidators: list['FrontendConfigAsyncValidator'] | None = Field(  # noqa: F405, N815
+        None,
+        title='Async Validators',
+    )
+    activators: list['FrontendActivatorConfig'] | None = Field(None, title='Activators')  # noqa: F405
+    additionalText: str | None = Field(None, title='Additional Text')  # noqa: N815
+    value: Any | None = Field(None, title='Value')
+    placeholder: str | None = Field(None, title='Placeholder')
+    options: list['FrontendConfigOption'] | None = Field(None, title='Options')  # noqa: F405
+    mask: Optional['FrontendConfigTextMask'] = Field(None, title='Mask')  # noqa: F405
+    controls: list['FrontendControlConfig'] | None = Field(None, title='Controls')
+    showSearch: bool | None = Field(None, title='Show Search')  # noqa: N815
+    sliderOptions: Optional['FrontendConfigSliderOption'] = Field(None, title='Slider Option')  # noqa: F405, N815
+    customLabel: list[str] | None = Field(None, title='Custom Label')  # noqa: N815
+    control: Optional['FrontendControlConfig'] = Field(None, title='Control')
+    entityType: str | None = Field(None, title='Entity Type')  # noqa: N815
+
+    @field_validator('type')
+    @classmethod
+    def validate_value_in_options_type(cls: type, value: Any) -> Any:  # type: ignore # noqa: A003
+        return validate_options(
+            value,
+            options=[
+                'Bytes',
+                'array',
+                'checkbox',
+                'date',
+                'dateTriplet',
+                'datetime',
+                'dict',
+                'dropzone',
+                'email',
+                'file',
+                'group',
+                'group_switch',
+                'group_toggle',
+                'info-group',
+                'infoscreen',
+                'multiselect',
+                'number',
+                'number-operations',
+                'number-slider',
+                'number_equals',
+                'number_initial',
+                'number_minus',
+                'number_plus',
+                'object',
+                'object_group',
+                'object_latest',
+                'password',
+                'phone',
+                'radio',
+                'select',
+                'text',
+                'textarea',
+                'time',
+                'toggle',
+            ],
+        )

amsdal/contrib/frontend_configs/models/frontend_control_config.pyi

@@ -0,0 +1,35 @@
+from amsdal.contrib.frontend_configs.models.frontend_activator_config import *
+from amsdal.contrib.frontend_configs.models.frontend_config_async_validator import *
+from amsdal.contrib.frontend_configs.models.frontend_config_control_action import *
+from amsdal.contrib.frontend_configs.models.frontend_config_option import *
+from amsdal.contrib.frontend_configs.models.frontend_config_skip_none_base import *
+from amsdal.contrib.frontend_configs.models.frontend_config_slider_option import *
+from amsdal.contrib.frontend_configs.models.frontend_config_text_mask import *
+from amsdal.contrib.frontend_configs.models.frontend_config_validator import *
+from amsdal_utils.models.enums import ModuleType
+from typing import Any, ClassVar
+
+class FrontendControlConfig(FrontendConfigSkipNoneBase):
+    __module_type__: ClassVar[ModuleType]
+    type: str
+    name: str
+    label: str | None
+    required: bool | None
+    hideLabel: bool | None
+    actions: list['FrontendConfigControlAction'] | None
+    validators: list['FrontendConfigValidator'] | None
+    asyncValidators: list['FrontendConfigAsyncValidator'] | None
+    activators: list['FrontendActivatorConfig'] | None
+    additionalText: str | None
+    value: Any | None
+    placeholder: str | None
+    options: list['FrontendConfigOption'] | None
+    mask: FrontendConfigTextMask | None
+    controls: list['FrontendControlConfig'] | None
+    showSearch: bool | None
+    sliderOptions: FrontendConfigSliderOption | None
+    customLabel: list[str] | None
+    control: FrontendControlConfig | None
+    entityType: str | None
+    @classmethod
+    def validate_value_in_options_type(cls, value: Any) -> Any: ...

amsdal/contrib/frontend_configs/models/frontend_model_config.py

@@ -0,0 +1,14 @@
+from typing import ClassVar
+from typing import Optional
+
+from amsdal_models.classes.model import Model
+from amsdal_utils.models.enums import ModuleType
+from pydantic.fields import Field
+
+from amsdal.contrib.frontend_configs.models.frontend_control_config import *  # noqa: F403
+
+
+class FrontendModelConfig(Model):
+    __module_type__: ClassVar[ModuleType] = ModuleType.CONTRIB
+    class_name: str = Field(title='Class Name')
+    control: Optional['FrontendControlConfig'] = Field(None, title='Control')  # noqa: F405

amsdal/contrib/frontend_configs/models/frontend_model_config.pyi

@@ -0,0 +1,9 @@
+from amsdal.contrib.frontend_configs.models.frontend_control_config import *
+from amsdal_models.classes.model import Model
+from amsdal_utils.models.enums import ModuleType
+from typing import ClassVar
+
+class FrontendModelConfig(Model):
+    __module_type__: ClassVar[ModuleType] = ...
+    class_name: str = ...
+    control: FrontendControlConfig | None = ...

amsdal/contrib/frontend_configs/utils.py

@@ -0,0 +1,29 @@
+from typing import Any
+
+
+def merge_ui_configs(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]:
+    """
+    Merges two UI configs together. The override config will take precedence over the base config.
+
+    This function recursively merges two dictionaries representing UI configurations.
+    If a key exists in both dictionaries, the value from the override dictionary will be used.
+    If the value is a dictionary or a list, the function will merge them recursively.
+
+    Args:
+        base (dict[str, Any]): The base UI configuration dictionary.
+        override (dict[str, Any]): The override UI configuration dictionary.
+
+    Returns:
+        dict[str, Any]: The merged UI configuration dictionary.
+    """
+    for key, value in override.items():
+        if key not in base:
+            base[key] = value
+        elif isinstance(value, dict):
+            base[key] = merge_ui_configs(base[key], value)
+        elif isinstance(value, list):
+            base[key] = [merge_ui_configs(base[key], item) for item in value]
+        else:
+            base[key] = value
+
+    return base

amsdal/contrib/frontend_configs/utils.pyi

@@ -0,0 +1,17 @@
+from typing import Any
+
+def merge_ui_configs(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]:
+    """
+    Merges two UI configs together. The override config will take precedence over the base config.
+
+    This function recursively merges two dictionaries representing UI configurations.
+    If a key exists in both dictionaries, the value from the override dictionary will be used.
+    If the value is a dictionary or a list, the function will merge them recursively.
+
+    Args:
+        base (dict[str, Any]): The base UI configuration dictionary.
+        override (dict[str, Any]): The override UI configuration dictionary.
+
+    Returns:
+        dict[str, Any]: The merged UI configuration dictionary.
+    """

amsdal/errors.py

@@ -0,0 +1,31 @@
+from amsdal_utils.errors import AmsdalError
+
+
+class AmsdalRuntimeError(AmsdalError): ...
+
+
+class TransactionNotFoundError(AmsdalError): ...
+
+
+class AmsdalAuthenticationError(AmsdalRuntimeError): ...
+
+
+class AmsdalDeployError(AmsdalRuntimeError): ...
+
+
+class AmsdalCloudError(AmsdalRuntimeError): ...
+
+
+class AmsdalCloudAlreadyDeployedError(AmsdalCloudError): ...
+
+
+class AmsdalCloudCredentialsError(AmsdalCloudError): ...
+
+
+class AmsdalMissingCredentialsError(AmsdalAuthenticationError): ...
+
+
+class AmsdalAuthConnectionError(AmsdalAuthenticationError): ...
+
+
+class AmsdalSignupError(AmsdalAuthenticationError): ...

amsdal/errors.pyi

@@ -0,0 +1,12 @@
+from amsdal_utils.errors import AmsdalError
+
+class AmsdalRuntimeError(AmsdalError): ...
+class TransactionNotFoundError(AmsdalError): ...
+class AmsdalAuthenticationError(AmsdalRuntimeError): ...
+class AmsdalDeployError(AmsdalRuntimeError): ...
+class AmsdalCloudError(AmsdalRuntimeError): ...
+class AmsdalCloudAlreadyDeployedError(AmsdalCloudError): ...
+class AmsdalCloudCredentialsError(AmsdalCloudError): ...
+class AmsdalMissingCredentialsError(AmsdalAuthenticationError): ...
+class AmsdalAuthConnectionError(AmsdalAuthenticationError): ...
+class AmsdalSignupError(AmsdalAuthenticationError): ...

amsdal/fixtures/manager.pyi

@@ -0,0 +1,170 @@
+from _typeshed import Incomplete
+from amsdal.fixtures.utils import process_fixture_value as process_fixture_value
+from amsdal_models.classes.model import Model
+from collections.abc import Generator
+from pathlib import Path
+from pydantic import BaseModel
+from pydantic.fields import FieldInfo as FieldInfo
+from typing import Any
+
+logger: Incomplete
+
+class FixtureData(BaseModel):
+    class_name: str
+    external_id: str
+    order: float
+    data: dict[str, Any]
+
+class BaseFixturesManager:
+    ORDER_MULTIPLIER: int
+    fixtures_paths: Incomplete
+    fixtures: dict[str | int, list[tuple[float, FixtureData]]]
+    _class_manager: Incomplete
+    _config_manager: Incomplete
+    def __init__(self, fixtures_paths: list[Path]) -> None: ...
+    def load_fixtures(self) -> None:
+        """
+        Loads fixture data from the specified path.
+
+        This method reads fixture data from a JSON file located at the `fixtures_path`.
+        It populates the `fixtures` dictionary with the loaded data, where each fixture
+        is indexed by its external ID.
+
+        Returns:
+            None
+        """
+    def _load_fixtures(self, fixtures_path: Path, order_shift: int = 0) -> None: ...
+    def iter_fixtures(self) -> Generator[FixtureData, None, None]: ...
+    def _process_object_data(self, data: dict[str, Any], model_fields: dict[str, FieldInfo], m2m_fields: dict[str, type[Model]]) -> dict[str, Any]: ...
+
+class FixturesManager(BaseFixturesManager):
+    """
+    Manager class for handling fixture data.
+
+    This class is responsible for loading, processing, and applying fixture data
+    to the database. It supports nested object construction, data processing,
+    and file fixture handling.
+    """
+    def apply_file_fixtures(self) -> None:
+        """
+        Applies file fixtures from the specified directory.
+
+        This method processes file fixtures located in the 'files' directory adjacent to the
+        `fixtures_path`. It iterates through each file, reads its content, and processes it
+        as a fixture. If the file fixture already exists in the database, it updates the
+        existing fixture; otherwise, it creates a new one.
+
+        Returns:
+            None
+        """
+    def _apply_file_fixtures(self, file_dir: Path) -> None: ...
+    def _apply_file_fixtures_rec(self, nested_dir: Path, base_dir: Path) -> None: ...
+    def apply_fixtures(self) -> None:
+        """
+        Applies all loaded fixtures to the database.
+
+        This method processes each fixture in the `fixtures` dictionary in the order
+        specified by their 'order' value. It calls the `process_fixture` method for
+        each fixture and then processes the data in the processing queue.
+
+        Returns:
+            None
+        """
+    def _process_file_fixture(self, file_path: Path, file_key: str) -> None: ...
+    def _process_fixture(self, fixture: FixtureData) -> FixtureData | None:
+        """
+        Processes a single fixture and adds it to the processing queue.
+
+        This method takes a fixture dictionary, checks if the fixture already exists in the database,
+        and either updates the existing fixture or creates a new one. It then adds the fixture data
+        to the processing queue for further processing.
+
+        Args:
+            fixture (dict[str, Any]): The fixture dictionary containing the external ID, class name,
+            and data of the fixture.
+
+        Returns:
+            None
+        """
+    def _process_fixture_object_data(self, class_name: str, external_id: str, data: dict[str, Any]) -> None:
+        """
+        Processes and saves fixture object data to the database.
+
+        This method takes the class name, external ID, and data dictionary of a fixture object,
+        processes the data according to the class schema, and saves the object to the database.
+        If the object already exists, it updates the existing object with the new data.
+
+        Args:
+            class_name (str): The name of the class to which the fixture object belongs.
+            external_id (str): The external ID of the fixture object.
+            data (dict[str, Any]): The data dictionary of the fixture object.
+
+        Returns:
+            None
+        """
+
+class AsyncFixturesManager(BaseFixturesManager):
+    """
+    Manager class for handling fixture data asynchronously.
+
+    This class is responsible for loading, processing, and applying fixture data
+    to the database. It supports nested object construction, data processing,
+    and file fixture handling.
+    """
+    async def apply_file_fixtures(self) -> None:
+        """
+        Applies file fixtures from the specified directory.
+
+        This method processes file fixtures located in the 'files' directory adjacent to the
+        `fixtures_path`. It iterates through each file, reads its content, and processes it
+        as a fixture. If the file fixture already exists in the database, it updates the
+        existing fixture; otherwise, it creates a new one.
+
+        Returns:
+            None
+        """
+    async def _apply_file_fixtures(self, file_dir: Path) -> None: ...
+    async def _apply_file_fixtures_rec(self, nested_dir: Path, base_dir: Path) -> None: ...
+    async def apply_fixtures(self) -> None:
+        """
+        Applies all loaded fixtures to the database.
+
+        This method processes each fixture in the `fixtures` dictionary in the order
+        specified by their 'order' value. It calls the `process_fixture` method for
+        each fixture and then processes the data in the processing queue.
+
+        Returns:
+            None
+        """
+    async def _process_file_fixture(self, file_path: Path, file_key: str) -> None: ...
+    async def _process_fixture(self, fixture: FixtureData) -> FixtureData | None:
+        """
+        Processes a single fixture and adds it to the processing queue.
+
+        This method takes a fixture dictionary, checks if the fixture already exists in the database,
+        and either updates the existing fixture or creates a new one. It then adds the fixture data
+        to the processing queue for further processing.
+
+        Args:
+            fixture (dict[str, Any]): The fixture dictionary containing the external ID, class name,
+            and data of the fixture.
+
+        Returns:
+            None
+        """
+    async def _process_fixture_object_data(self, class_name: str, external_id: str, data: dict[str, Any]) -> None:
+        """
+        Processes and saves fixture object data to the database.
+
+        This method takes the class name, external ID, and data dictionary of a fixture object,
+        processes the data according to the class schema, and saves the object to the database.
+        If the object already exists, it updates the existing object with the new data.
+
+        Args:
+            class_name (str): The name of the class to which the fixture object belongs.
+            external_id (str): The external ID of the fixture object.
+            data (dict[str, Any]): The data dictionary of the fixture object.
+
+        Returns:
+            None
+        """

amsdal/fixtures/utils.pyi

@@ -0,0 +1,9 @@
+from amsdal_utils.models.data_models.reference import Reference
+from types import GenericAlias
+from typing import Any
+
+def process_fixture_value(annotation: Any, value: Any) -> Any: ...
+def _cast_value_to_type(value_type: type | GenericAlias, value: Any) -> Any: ...
+def _is_optional(annotation: Any) -> bool: ...
+def _resolve_type_from_optional(annotation: Any) -> Any: ...
+def _construct_reference_value(class_name: str, object_id: Any) -> Reference: ...