amsdal 0.3.5__cp312-cp312-macosx_10_13_universal2.whl → 0.4.0__cp312-cp312-macosx_10_13_universal2.whl

amsdal/migration/file_migration_generator.pyi

@@ -1,229 +0,0 @@
-from _typeshed import Incomplete
-from amsdal.configs.main import settings as settings
-from amsdal.migration.base_migration_schemas import BaseMigrationSchemas as BaseMigrationSchemas
-from amsdal.migration.data_classes import MigrateOperation as MigrateOperation, MigrationFile as MigrationFile, ModuleTypes as ModuleTypes, OperationTypes as OperationTypes
-from amsdal.migration.executors.state_executor import AsyncStateMigrationExecutor as AsyncStateMigrationExecutor, StateMigrationExecutor as StateMigrationExecutor
-from amsdal.migration.file_migration_executor import AsyncFileMigrationExecutorManager as AsyncFileMigrationExecutorManager, FileMigrationExecutorManager as FileMigrationExecutorManager
-from amsdal.migration.file_migration_store import AsyncBaseMigrationStore as AsyncBaseMigrationStore, BaseMigrationStore as BaseMigrationStore
-from amsdal.migration.file_migration_writer import FileMigrationWriter as FileMigrationWriter
-from amsdal.migration.migrations_loader import MigrationsLoader as MigrationsLoader
-from amsdal.migration.schemas_loaders import BaseClassSchemaLoader as BaseClassSchemaLoader
-from amsdal_utils.models.data_models.schema import ObjectSchema as ObjectSchema
-from amsdal_utils.models.enums import SchemaTypes, Versions
-from collections.abc import Callable as Callable
-from pathlib import Path
-from typing import ClassVar
-
-class StateMigrationStore(BaseMigrationStore):
-    def save_migration(self, migration: MigrationFile) -> None: ...
-    def delete_migration(self, migration: MigrationFile) -> None: ...
-    def fetch_migrations(self) -> list[MigrationFile]: ...
-
-class AsyncStateMigrationStore(AsyncBaseMigrationStore):
-    async def save_migration(self, migration: MigrationFile) -> None: ...
-    async def delete_migration(self, migration: MigrationFile) -> None: ...
-    async def fetch_migrations(self) -> list[MigrationFile]: ...
-
-class StateMigrationSchemas(BaseMigrationSchemas):
-    """
-    Manages the state of migration schemas.
-
-    Attributes:
-        state (dict[str, tuple[SchemaTypes, ObjectSchema]]): A dictionary mapping class names to their schema types
-            and object schemas.
-    """
-    state: Incomplete
-    def __init__(self) -> None: ...
-    def register_model(self, class_name: str, object_schema: ObjectSchema, schema_type: SchemaTypes, class_version: str | Versions = ...) -> None:
-        """
-        Registers a model with the given class name, object schema, and schema type.
-
-        Args:
-            class_name (str): The name of the class to register.
-            object_schema (ObjectSchema): The object schema of the class.
-            schema_type (SchemaTypes): The type of schema.
-
-        Returns:
-            None
-        """
-    def unregister_model(self, class_name: str) -> None:
-        """
-        Unregisters a model with the given class name.
-
-        Args:
-            class_name (str): The name of the class to unregister.
-
-        Returns:
-            None
-        """
-    def compile_buffered_classes(self) -> None: ...
-
-class FileMigrationGenerator:
-    """
-    Generates migration files based on schema changes.
-    """
-    _operations: ClassVar[dict[OperationTypes, Callable[..., MigrateOperation]]]
-    _app_migrations_path: Incomplete
-    _app_migrations_loader: Incomplete
-    _schema_loader: Incomplete
-    _state: Incomplete
-    def __init__(self, schema_loader: BaseClassSchemaLoader, app_migrations_path: Path | None = None) -> None: ...
-    def make_migrations(self, name: str | None = None, *, is_data: bool = False, schema_type: SchemaTypes = ...) -> MigrationFile:
-        """
-        Creates migration files based on schema changes.
-
-        Args:
-            name (str | None): The name of the migration. Defaults to None.
-            is_data (bool): If True, creates a data migration. Defaults to False.
-            schema_type (SchemaTypes): The type of schema. Defaults to SchemaTypes.USER.
-
-        Returns:
-            MigrationFile: The created migration file.
-
-        Raises:
-            UserWarning: If no changes are detected.
-        """
-    def generate_operations(self, schema_type: SchemaTypes) -> list[MigrateOperation]:
-        """
-        Generates migration operations based on schema changes.
-
-        Args:
-            schema_type (SchemaTypes): The type of schema.
-
-        Returns:
-            list[MigrateOperation]: List of migration operations.
-        """
-    def _make_data_migrations(self, name: str | None = None) -> MigrationFile: ...
-    def _init_state(self) -> None: ...
-    @classmethod
-    def build_operations(cls, schema_type: SchemaTypes, class_schema: ObjectSchema, old_class_schema: ObjectSchema | None) -> list[MigrateOperation]:
-        """
-        Builds migration operations based on schema changes.
-
-        Args:
-            schema_type (SchemaTypes): The type of schema.
-            class_schema (ObjectSchema): The new class schema.
-            old_class_schema (ObjectSchema | None): The old class schema. Defaults to None.
-
-        Returns:
-            list[MigrateOperation]: List of migration operations.
-        """
-    def write_migration_file(self, operations: list[MigrateOperation], name: str | None = None) -> MigrationFile:
-        """
-        Writes migration operations to a file.
-
-        Args:
-            operations (list[MigrateOperation]): List of migration operations.
-            name (str | None): The name of the migration. Defaults to None.
-
-        Returns:
-            MigrationFile: The created migration file.
-        """
-    def write_data_migration_file(self, name: str | None = None) -> MigrationFile:
-        """
-        Writes data migration operations to a file.
-
-        Args:
-            name (str | None): The name of the migration. Defaults to None.
-
-        Returns:
-            MigrationFile: The created data migration file.
-        """
-    @staticmethod
-    def generate_name_from_operations(operations: list[MigrateOperation]) -> str:
-        """
-        Generates a name for the migration file based on operations.
-
-        Args:
-            operations (list[MigrateOperation]): List of migration operations.
-
-        Returns:
-            str: The generated name.
-        """
-    @staticmethod
-    def _get_migration_file_name(number: int, name: str) -> str: ...
-
-class AsyncFileMigrationGenerator:
-    """
-    Generates migration files based on schema changes.
-    """
-    _operations: ClassVar[dict[OperationTypes, Callable[..., MigrateOperation]]]
-    _app_migrations_path: Incomplete
-    _app_migrations_loader: Incomplete
-    _schema_loader: Incomplete
-    _state: Incomplete
-    def __init__(self, schema_loader: BaseClassSchemaLoader, app_migrations_path: Path | None = None) -> None: ...
-    async def make_migrations(self, name: str | None = None, *, is_data: bool = False, schema_type: SchemaTypes = ...) -> MigrationFile:
-        """
-        Creates migration files based on schema changes.
-
-        Args:
-            name (str | None): The name of the migration. Defaults to None.
-            is_data (bool): If True, creates a data migration. Defaults to False.
-            schema_type (SchemaTypes): The type of schema. Defaults to SchemaTypes.USER.
-
-        Returns:
-            MigrationFile: The created migration file.
-
-        Raises:
-            UserWarning: If no changes are detected.
-        """
-    async def generate_operations(self, schema_type: SchemaTypes) -> list[MigrateOperation]:
-        """
-        Generates migration operations based on schema changes.
-
-        Args:
-            schema_type (SchemaTypes): The type of schema.
-
-        Returns:
-            list[MigrateOperation]: List of migration operations.
-        """
-    def _make_data_migrations(self, name: str | None = None) -> MigrationFile: ...
-    async def _init_state(self) -> None: ...
-    @classmethod
-    def build_operations(cls, schema_type: SchemaTypes, class_schema: ObjectSchema, old_class_schema: ObjectSchema | None) -> list[MigrateOperation]:
-        """
-        Builds migration operations based on schema changes.
-
-        Args:
-            schema_type (SchemaTypes): The type of schema.
-            class_schema (ObjectSchema): The new class schema.
-            old_class_schema (ObjectSchema | None): The old class schema. Defaults to None.
-
-        Returns:
-            list[MigrateOperation]: List of migration operations.
-        """
-    def write_migration_file(self, operations: list[MigrateOperation], name: str | None = None) -> MigrationFile:
-        """
-        Writes migration operations to a file.
-
-        Args:
-            operations (list[MigrateOperation]): List of migration operations.
-            name (str | None): The name of the migration. Defaults to None.
-
-        Returns:
-            MigrationFile: The created migration file.
-        """
-    def write_data_migration_file(self, name: str | None = None) -> MigrationFile:
-        """
-        Writes data migration operations to a file.
-
-        Args:
-            name (str | None): The name of the migration. Defaults to None.
-
-        Returns:
-            MigrationFile: The created data migration file.
-        """
-    @staticmethod
-    def generate_name_from_operations(operations: list[MigrateOperation]) -> str:
-        """
-        Generates a name for the migration file based on operations.
-
-        Args:
-            operations (list[MigrateOperation]): List of migration operations.
-
-        Returns:
-            str: The generated name.
-        """
-    @staticmethod
-    def _get_migration_file_name(number: int, name: str) -> str: ...

amsdal/migration/file_migration_store.pyi

@@ -1,114 +0,0 @@
-import abc
-from _typeshed import Incomplete
-from abc import ABC, abstractmethod
-from amsdal.configs.main import settings as settings
-from amsdal.migration.data_classes import MigrationFile as MigrationFile, ModuleTypes as ModuleTypes
-from amsdal.migration.utils import contrib_to_module_root_path as contrib_to_module_root_path, map_module_type_to_schema_type as map_module_type_to_schema_type
-from amsdal_utils.models.data_models.address import Address
-from typing import Any, ClassVar
-
-class BaseMigrationStore(ABC, metaclass=abc.ABCMeta):
-    @abstractmethod
-    def fetch_migrations(self) -> list[MigrationFile]: ...
-    @abstractmethod
-    def save_migration(self, migration: MigrationFile) -> None: ...
-    @abstractmethod
-    def delete_migration(self, migration: MigrationFile) -> None: ...
-
-class AsyncBaseMigrationStore(ABC, metaclass=abc.ABCMeta):
-    @abstractmethod
-    async def fetch_migrations(self) -> list[MigrationFile]: ...
-    @abstractmethod
-    async def save_migration(self, migration: MigrationFile) -> None: ...
-    @abstractmethod
-    async def delete_migration(self, migration: MigrationFile) -> None: ...
-
-class FileMigrationStore(BaseMigrationStore):
-    """
-    Manages the storage and retrieval of migration files.
-
-    Attributes:
-        migration_address (Address): The address associated with the migration.
-    """
-    MIGRATION_TABLE: ClassVar[str]
-    migration_address: Address
-    _operation_manager: Incomplete
-    def __init__(self) -> None: ...
-    def fetch_migrations(self) -> list[MigrationFile]:
-        """
-        Fetches the list of applied migrations.
-
-        Returns:
-            list[MigrationFile]: List of applied migration files.
-        """
-    def save_migration(self, migration: MigrationFile) -> None:
-        """
-        Saves a migration file.
-
-        Args:
-            migration (MigrationFile): The migration file to save.
-
-        Returns:
-            None
-        """
-    def delete_migration(self, migration: MigrationFile) -> None:
-        """
-        Deletes a migration file.
-
-        Args:
-            migration (MigrationFile): The migration file to delete.
-
-        Returns:
-            None
-        """
-    def _save_historical_data(self, address: Address, data: dict[str, Any], metadata: dict[str, Any]) -> None: ...
-    @staticmethod
-    def _build_migration_data(migration: MigrationFile) -> dict[str, Any]: ...
-    @classmethod
-    def _build_migration_metadata(cls, migration: MigrationFile, object_id: str | None = None) -> tuple[Address, dict[str, Any]]: ...
-    def _init_migration_table(self) -> None: ...
-
-class AsyncFileMigrationStore(AsyncBaseMigrationStore):
-    """
-    Manages the storage and retrieval of migration files.
-
-    Attributes:
-        migration_address (Address): The address associated with the migration.
-    """
-    MIGRATION_TABLE: ClassVar[str]
-    migration_address: Address
-    _operation_manager: Incomplete
-    def __init__(self) -> None: ...
-    async def fetch_migrations(self) -> list[MigrationFile]:
-        """
-        Fetches the list of applied migrations.
-
-        Returns:
-            list[MigrationFile]: List of applied migration files.
-        """
-    async def save_migration(self, migration: MigrationFile) -> None:
-        """
-        Saves a migration file.
-
-        Args:
-            migration (MigrationFile): The migration file to save.
-
-        Returns:
-            None
-        """
-    async def delete_migration(self, migration: MigrationFile) -> None:
-        """
-        Deletes a migration file.
-
-        Args:
-            migration (MigrationFile): The migration file to delete.
-
-        Returns:
-            None
-        """
-    async def _save_historical_data(self, address: Address, data: dict[str, Any], metadata: dict[str, Any]) -> None: ...
-    @staticmethod
-    def _build_migration_data(migration: MigrationFile) -> dict[str, Any]: ...
-    @classmethod
-    def _build_migration_metadata(cls, migration: MigrationFile, object_id: str | None = None) -> tuple[Address, dict[str, Any]]: ...
-    async def _init_migration_table(self) -> None: ...

amsdal/migration/file_migration_writer.pyi

@@ -1,73 +0,0 @@
-from amsdal.migration.data_classes import MigrateOperation as MigrateOperation, OperationTypes as OperationTypes
-from pathlib import Path
-from typing import ClassVar
-
-class FileMigrationWriter:
-    """
-    Handles the writing of migration files.
-
-    Attributes:
-        template_path (Path): The path to the migration template file.
-        data_template_path (Path): The path to the data migration template file.
-        operation_name_map (ClassVar[dict[OperationTypes, str]]): A mapping of operation types to their
-            string representations.
-    """
-    template_path: Path
-    data_template_path: Path
-    operation_name_map: ClassVar[dict[OperationTypes, str]]
-    @classmethod
-    def write(cls, file_path: Path, operations: list[MigrateOperation]) -> None:
-        """
-        Writes the migration operations to a file.
-
-        Args:
-            file_path (Path): The path to the migration file.
-            operations (list[MigrateOperation]): The list of migration operations to write.
-
-        Returns:
-            None
-        """
-    @classmethod
-    def write_data_migration(cls, file_path: Path) -> None:
-        """
-        Writes a data migration to a file.
-
-        Args:
-            file_path (Path): The path to the data migration file.
-
-        Returns:
-            None
-        """
-    @classmethod
-    def render(cls, operations: list[MigrateOperation]) -> str:
-        """
-        Renders the migration operations into a string.
-
-        Args:
-            operations (list[MigrateOperation]): The list of migration operations to render.
-
-        Returns:
-            str: The rendered migration operations as a string.
-        """
-    @classmethod
-    def render_operation(cls, operation: MigrateOperation) -> str:
-        """
-        Renders a single migration operation into a string.
-
-        Args:
-            operation (MigrateOperation): The migration operation to render.
-
-        Returns:
-            str: The rendered migration operation as a string.
-        """
-    @classmethod
-    def reformat(cls, content: str) -> str:
-        """
-        Reformats the content using the Black formatter.
-
-        Args:
-            content (str): The content to reformat.
-
-        Returns:
-            str: The reformatted content.
-        """

amsdal/migration/migrations.pyi

@@ -1,166 +0,0 @@
-import abc
-from _typeshed import Incomplete
-from abc import ABC, abstractmethod
-from amsdal.migration.base_migration_schemas import BaseMigrationSchemas as BaseMigrationSchemas, DefaultMigrationSchemas as DefaultMigrationSchemas
-from amsdal.migration.executors.base import BaseMigrationExecutor as BaseMigrationExecutor
-from amsdal_utils.models.enums import SchemaTypes as SchemaTypes
-from collections.abc import Callable as Callable
-from typing import Any
-
-class Operation(ABC, metaclass=abc.ABCMeta):
-    @abstractmethod
-    def forward(self, executor: BaseMigrationExecutor) -> None: ...
-    @abstractmethod
-    def forward_schema(self, executor: BaseMigrationExecutor) -> None: ...
-    @abstractmethod
-    def backward(self, executor: BaseMigrationExecutor) -> None: ...
-
-class SchemaOperation(Operation):
-    """
-    Base class for schema operations.
-
-    Attributes:
-        forward_args (list[Any]): Arguments for the forward operation.
-        backward_args (list[Any]): Arguments for the backward operation.
-        forward_method_name (str): Name of the method to call for the forward operation.
-        backward_method_name (str): Name of the method to call for the backward operation.
-    """
-    forward_args: list[Any]
-    backward_args: list[Any]
-    forward_method_name: str
-    backward_method_name: str
-    def forward(self, executor: BaseMigrationExecutor) -> None:
-        """
-        Executes the forward operation.
-
-        Args:
-            executor (BaseMigrationExecutor): The executor responsible for running migrations.
-
-        Returns:
-            None
-        """
-    def forward_schema(self, executor: BaseMigrationExecutor) -> None:
-        """
-        Executes the forward schema operation.
-
-        Args:
-            executor (BaseMigrationExecutor): The executor responsible for running migrations.
-
-        Returns:
-            None
-        """
-    def backward(self, executor: BaseMigrationExecutor) -> None:
-        """
-        Executes the backward operation.
-
-        Args:
-            executor (BaseMigrationExecutor): The executor responsible for running migrations.
-
-        Returns:
-            None
-        """
-
-class CreateClass(SchemaOperation):
-    """
-    Represents an operation to create a class schema.
-
-    Attributes:
-        forward_method_name (str): The name of the method to call for the forward operation.
-        backward_method_name (str): The name of the method to call for the backward operation.
-        forward_args (list[Any]): Arguments for the forward operation.
-        backward_args (list[Any]): Arguments for the backward operation.
-    """
-    forward_method_name: str
-    backward_method_name: str
-    forward_args: Incomplete
-    backward_args: Incomplete
-    def __init__(self, class_name: str, new_schema: dict[str, Any], schema_type: SchemaTypes) -> None: ...
-
-class UpdateClass(SchemaOperation):
-    """
-    Represents an operation to update a class schema.
-
-    Attributes:
-        forward_method_name (str): The name of the method to call for the forward operation.
-        backward_method_name (str): The name of the method to call for the backward operation.
-        forward_args (list[Any]): Arguments for the forward operation.
-        backward_args (list[Any]): Arguments for the backward operation.
-    """
-    forward_method_name: str
-    backward_method_name: str
-    forward_args: Incomplete
-    backward_args: Incomplete
-    def __init__(self, class_name: str, old_schema: dict[str, Any], new_schema: dict[str, Any], schema_type: SchemaTypes) -> None: ...
-
-class DeleteClass(SchemaOperation):
-    """
-    Represents an operation to delete a class schema.
-
-    Attributes:
-        forward_method_name (str): The name of the method to call for the forward operation.
-        backward_method_name (str): The name of the method to call for the backward operation.
-        forward_args (list[Any]): Arguments for the forward operation.
-        backward_args (list[Any]): Arguments for the backward operation.
-    """
-    forward_method_name: str
-    backward_method_name: str
-    forward_args: Incomplete
-    backward_args: Incomplete
-    def __init__(self, class_name: str, old_schema: dict[str, Any], schema_type: SchemaTypes) -> None: ...
-
-class MigrationSchemas(DefaultMigrationSchemas): ...
-
-class MigrateData(Operation):
-    """
-    Represents a data migration operation.
-
-    Attributes:
-        forward_migration (Callable[[MigrationSchemas \\| BaseMigrationSchemas], None]): The function to call for
-            the forward migration.
-        backward_migration (Callable[[MigrationSchemas \\| BaseMigrationSchemas], None]): The function to call for
-            the backward migration.
-    """
-    @staticmethod
-    def noop(schemas: MigrationSchemas) -> None: ...
-    forward_migration: Incomplete
-    backward_migration: Incomplete
-    def __init__(self, forward_migration: Callable[[MigrationSchemas | BaseMigrationSchemas], None], backward_migration: Callable[[MigrationSchemas | BaseMigrationSchemas], None]) -> None: ...
-    def forward(self, executor: BaseMigrationExecutor) -> None:
-        """
-        Executes the forward data migration.
-
-        Args:
-            executor (BaseMigrationExecutor): The executor responsible for running migrations.
-
-        Returns:
-            None
-        """
-    def backward(self, executor: BaseMigrationExecutor) -> None:
-        """
-        Executes the backward data migration.
-
-        Args:
-            executor (BaseMigrationExecutor): The executor responsible for running migrations.
-
-        Returns:
-            None
-        """
-    def forward_schema(self, executor: BaseMigrationExecutor) -> None:
-        """
-        No-op for forward schema in data migration.
-
-        Args:
-            executor (BaseMigrationExecutor): The executor responsible for running migrations.
-
-        Returns:
-            None
-        """
-
-class Migration:
-    """
-    Represents a collection of migration operations.
-
-    Attributes:
-        operations (list[Operation]): The list of migration operations.
-    """
-    operations: list[Operation]

amsdal/migration/migrations_loader.pyi

@@ -1,32 +0,0 @@
-from _typeshed import Incomplete
-from amsdal.migration.data_classes import MigrationFile as MigrationFile, ModuleTypes as ModuleTypes
-from collections.abc import Iterator
-from pathlib import Path
-
-class MigrationsLoader:
-    """
-    Loads and manages migration files from a specified directory.
-    """
-    _migrations_path: Incomplete
-    _module_type: Incomplete
-    _module_name: Incomplete
-    _migrations_files: Incomplete
-    def __init__(self, migrations_dir: Path, module_type: ModuleTypes, module_name: str | None = None) -> None: ...
-    @property
-    def has_initial_migration(self) -> bool:
-        """
-        Checks if there is an initial migration file.
-
-        Returns:
-            bool: True if there is an initial migration file, False otherwise.
-        """
-    @property
-    def last_migration_number(self) -> int:
-        """
-        Gets the number of the last migration file.
-
-        Returns:
-            int: The number of the last migration file, or -1 if there are no migration files.
-        """
-    def __iter__(self) -> Iterator[MigrationFile]: ...
-    def _load_migration_files(self) -> None: ...

amsdal/migration/schemas_loaders.pyi

@@ -1,37 +0,0 @@
-import abc
-from _typeshed import Incomplete
-from abc import ABC, abstractmethod
-from amsdal.configs.constants import CORE_SCHEMAS_PATH as CORE_SCHEMAS_PATH, TYPE_SCHEMAS_PATH as TYPE_SCHEMAS_PATH
-from amsdal.configs.main import settings as settings
-from amsdal.migration.data_classes import ClassSchema as ClassSchema, ModuleTypes as ModuleTypes
-from amsdal_models.schemas.mixins.enrich_schemas_mixin import EnrichSchemasMixin
-from amsdal_utils.models.data_models.schema import ObjectSchema as ObjectSchema
-from collections.abc import Iterator
-from pathlib import Path
-
-class BaseClassSchemaLoader(ABC, metaclass=abc.ABCMeta):
-    @abstractmethod
-    def iter_app_schemas(self) -> Iterator[ClassSchema]: ...
-
-class JsonClassSchemaLoader(EnrichSchemasMixin, BaseClassSchemaLoader):
-    """
-    Loads and enriches JSON class schemas from a specified root path.
-
-    Attributes:
-        schemas_root_path (Path): The root path to the JSON schemas.
-        module_type (ModuleTypes): The type of the module for the schemas.
-    """
-    schemas_root_path: Incomplete
-    module_type: Incomplete
-    def __init__(self, schemas_root_path: Path, module_type: ModuleTypes = ...) -> None: ...
-    def iter_app_schemas(self) -> Iterator[ClassSchema]:
-        """
-        Iterates over the application schemas.
-
-        Yields:
-            ClassSchema: The next class schema in the iteration.
-        """
-    def _enriched_user_schemas(self) -> list[ObjectSchema]: ...
-    @staticmethod
-    def _load_schemas(schemas_path: Path) -> list[ObjectSchema]: ...
-    def _load_contrib_schemas(self) -> list[ObjectSchema]: ...

amsdal/migration/templates/data_migration.tmpl

@@ -1,18 +0,0 @@
-from amsdal.migration import migrations
-
-
-def forward_migration(schemas: migrations.MigrationSchemas) -> None:
-    ...
-
-
-def backward_migration(schemas: migrations.MigrationSchemas) -> None:
-    ...
-
-
-class Migration(migrations.Migration):
-    operations: list[migrations.Operation] = [
-        migrations.MigrateData(
-            forward_migration=forward_migration,
-            backward_migration=backward_migration,
-        ),
-    ]