arpakitlib 1.7.257__py3-none-any.whl → 1.8.1__py3-none-any.whl

arpakitlib/_arpakit_project_template_v_1/api/schema/common/in_.py

@@ -0,0 +1,5 @@
+from api.schema.base_schema import BaseSI
+
+
+class BaseCommonSI(BaseSI):
+    pass

arpakitlib/_arpakit_project_template_v_1/api/schema/common/out.py

@@ -0,0 +1,60 @@
+import datetime as dt
+from typing import Any
+
+from api.schema.base_schema import BaseSO
+
+
+class BaseCommonSO(BaseSO):
+    pass
+
+
+class ErrorCommonSO(BaseCommonSO):
+    has_error: bool = True
+    error_code: str | None = None
+    error_specification_code: str | None = None
+    error_description: str | None = None
+    error_data: dict[str, Any] = {}
+
+
+class DatetimeCommonSO(BaseCommonSO):
+    date: dt.date
+    datetime: dt.datetime | None = None
+    year: int
+    month: int
+    day: int
+    hour: int | None = None
+    minute: int | None = None
+    second: int | None = None
+    microsecond: int | None = None
+
+    @classmethod
+    def from_datetime(cls, datetime_: dt.datetime):
+        return cls(
+            date=datetime_.date(),
+            datetime=datetime_,
+            year=datetime_.year,
+            month=datetime_.month,
+            day=datetime_.day,
+            hour=datetime_.hour,
+            minute=datetime_.minute,
+            second=datetime_.second,
+            microsecond=datetime_.microsecond
+        )
+
+    @classmethod
+    def from_date(cls, date_: dt.date):
+        return cls(
+            date=date_,
+            year=date_.year,
+            month=date_.month,
+            day=date_.day
+        )
+
+
+class RawDataCommonSO(BaseCommonSO):
+    data: dict[str, Any] = {}
+
+
+class ErrorsInfoCommonSO(BaseCommonSO):
+    api_error_codes: list[str] = []
+    api_error_specification_codes: list[str] = []

arpakitlib/_arpakit_project_template_v_1/api/schema/v1/in_.py

@@ -0,0 +1,5 @@
+from api.schema.base_schema import BaseSI
+
+
+class BaseV1SI(BaseSI):
+    pass

arpakitlib/_arpakit_project_template_v_1/api/schema/v1/out.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+
+import datetime as dt
+from typing import Any
+
+from api.schema.base_schema import BaseSO
+from sqlalchemy_db.sqlalchemy_model import OperationDBM, StoryLogDBM
+
+
+class BaseV1SO(BaseSO):
+    pass
+
+
+class HealthcheckV1SO(BaseV1SO):
+    is_ok: bool = True
+
+
+class _SimpleDBMV1SO(BaseV1SO):
+    id: int
+    long_id: str
+    creation_dt: dt.datetime
+
+
+class StoryLogV1SO(_SimpleDBMV1SO):
+    level: str
+    type: str | None = None
+    title: str | None = None
+    data: dict[str, Any] = {}
+
+    @classmethod
+    def from_story_log_dbm(cls, *, story_log_dbm: StoryLogDBM) -> StoryLogV1SO:
+        return cls.model_validate(story_log_dbm.simple_dict_with_sd_properties())
+
+
+class OperationV1SO(_SimpleDBMV1SO):
+    execution_start_dt: dt.datetime | None = None
+    execution_finish_dt: dt.datetime | None = None
+    status: str
+    type: str
+    input_data: dict[str, Any] = {}
+    output_data: dict[str, Any] = {}
+    error_data: dict[str, Any] = {}
+    duration_total_seconds: float | None = None
+
+    @classmethod
+    def from_operation_dbm(cls, *, operation_dbm: OperationDBM) -> OperationV1SO:
+        return cls.model_validate(operation_dbm.simple_dict_with_sd_properties())

arpakitlib/_arpakit_project_template_v_1/arpakitlib_project_template.json

@@ -0,0 +1,3 @@
+{
+  "arpakitlib_project_template_version": "1"
+}

arpakitlib/{_arpakit_project_template/src → _arpakit_project_template_v_1}/business_service/hello_world.py

@@ -1,6 +1,6 @@
 import logging
 
-from src.core.util import setup_logging
+from core.util import setup_logging
 
 _logger = logging.getLogger(__name__)
 

arpakitlib/_arpakit_project_template_v_1/business_service/remove_operations.py

@@ -0,0 +1,51 @@
+import asyncio
+
+from arpakitlib.ar_type_util import raise_for_type
+from sqlalchemy_db.sqlalchemy_db import get_cached_sqlalchemy_db
+from sqlalchemy_db.sqlalchemy_model import OperationDBM
+
+
+def remove_operations(
+        *,
+        filter_operation_ids: list[int] | int | None = None,
+        filter_operation_statuses: list[str] | str | None = None,
+        filter_operation_types: list[str] | str | None = None,
+):
+    if isinstance(filter_operation_ids, int):
+        filter_operation_ids = [filter_operation_ids]
+    if filter_operation_ids is not None:
+        raise_for_type(filter_operation_ids, list)
+
+    if isinstance(filter_operation_statuses, str):
+        filter_operation_statuses = [filter_operation_statuses]
+    if filter_operation_statuses is not None:
+        raise_for_type(filter_operation_statuses, list)
+
+    if isinstance(filter_operation_types, str):
+        filter_operation_types = [filter_operation_types]
+    if filter_operation_types is not None:
+        raise_for_type(filter_operation_types, list)
+
+    with get_cached_sqlalchemy_db().new_session() as session:
+        query = session.query(OperationDBM)
+        if filter_operation_ids is not None:
+            query = query.filter(OperationDBM.id.in_(filter_operation_ids))
+        if filter_operation_statuses is not None:
+            query = query.filter(OperationDBM.status.in_(filter_operation_statuses))
+        if filter_operation_types is not None:
+            query = query.filter(OperationDBM.type.in_(filter_operation_types))
+        query.delete()
+        session.commit()
+
+
+def __example():
+    remove_operations(filter_operation_statuses="123")
+
+
+async def __async_example():
+    pass
+
+
+if __name__ == '__main__':
+    __example()
+    asyncio.run(__async_example())

arpakitlib/_arpakit_project_template_v_1/command/alembic_history.sh

@@ -0,0 +1,2 @@
+cd ..
+alembic history

arpakitlib/_arpakit_project_template_v_1/command/alembic_revision_autogenerate.sh

@@ -0,0 +1,2 @@
+cd ..
+alembic revision --autogenerate -m "no_message"

arpakitlib/{_arpakit_project_template/manage/json_beautify.py → _arpakit_project_template_v_1/command/beautify_json.py}

@@ -1,10 +1,10 @@
 from arpakitlib.ar_json_util import safely_transfer_str_to_json_obj_to_json_str
 
 
-def __json_beautify():
+def __command():
     s = input("JSON:\n")
     print(safely_transfer_str_to_json_obj_to_json_str(s))
 
 
 if __name__ == '__main__':
-    __json_beautify()
+    __command()

arpakitlib/{_arpakit_project_template/src/core/_check_logging.py → _arpakit_project_template_v_1/command/check_logging.py}

@@ -1,14 +1,14 @@
 import logging
 
-from src.core.util import setup_logging
+from core.util import setup_logging
 
 _logger = logging.getLogger(__name__)
 
 
-def _check_logging():
+def __command():
     setup_logging()
     _logger.info("logging is good")
 
 
 if __name__ == '__main__':
-    _check_logging()
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/check_sqlalchemy_db.py

@@ -0,0 +1,11 @@
+from core.util import setup_logging
+from sqlalchemy_db.sqlalchemy_db import get_cached_sqlalchemy_db
+
+
+def __command():
+    setup_logging()
+    get_cached_sqlalchemy_db().check_conn()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/drop_json_db.py

@@ -0,0 +1,13 @@
+from core.settings import get_cached_settings
+from core.util import setup_logging
+from json_db.json_db import get_cached_json_db
+
+
+def __command():
+    setup_logging()
+    get_cached_settings().raise_if_mode_type_prod()
+    get_cached_json_db().drop()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/drop_sqlalchemy_db.py

@@ -0,0 +1,14 @@
+from core.settings import get_cached_settings
+from core.util import setup_logging
+from sqlalchemy_db.sqlalchemy_db import get_cached_sqlalchemy_db
+
+
+def __command():
+    setup_logging()
+    get_cached_settings().raise_if_mode_type_prod()
+    get_cached_sqlalchemy_db().drop()
+    get_cached_sqlalchemy_db().drop_celery_tables()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/{_arpakit_project_template/src/core/_generate_settings_env_example.py → _arpakit_project_template_v_1/command/generate_settings_env_example.py}

@@ -1,14 +1,14 @@
 import os.path
 
 from arpakitlib.ar_json_util import safely_transfer_obj_to_json_str
-from src.core.const import ProjectPaths
-from src.core.settings import Settings, get_cached_settings
+from core.const import ProjectPaths
+from core.settings import Settings, get_cached_settings
 
 
-def _generate_settings_env_example():
+def __command():
     print(safely_transfer_obj_to_json_str(get_cached_settings().model_dump(mode="json")))
     Settings.save_env_example_to_file(filepath=os.path.join(ProjectPaths.base_dirpath, "example.env"))
 
 
 if __name__ == '__main__':
-    _generate_settings_env_example()
+    __command()

arpakitlib/{_arpakit_project_template/manage → _arpakit_project_template_v_1/command}/hello_world.py

@@ -1,6 +1,6 @@
-def __hello_world():
+def __command():
     print("Hello world")
 
 
 if __name__ == '__main__':
-    __hello_world()
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/init_json_db.py

@@ -0,0 +1,11 @@
+from core.util import setup_logging
+from json_db.json_db import get_cached_json_db
+
+
+def __command():
+    setup_logging()
+    get_cached_json_db().init()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/init_sqlalchemy_db.py

@@ -0,0 +1,11 @@
+from core.util import setup_logging
+from sqlalchemy_db.sqlalchemy_db import get_cached_sqlalchemy_db
+
+
+def __command():
+    setup_logging()
+    get_cached_sqlalchemy_db().init()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/reinit_json_db.py

@@ -0,0 +1,13 @@
+from core.settings import get_cached_settings
+from core.util import setup_logging
+from json_db.json_db import get_cached_json_db
+
+
+def __command():
+    setup_logging()
+    get_cached_settings().raise_if_mode_type_prod()
+    get_cached_json_db().reinit()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/reinit_sqlalchemy_db.py

@@ -0,0 +1,13 @@
+from core.settings import get_cached_settings
+from core.util import setup_logging
+from sqlalchemy_db.sqlalchemy_db import get_cached_sqlalchemy_db
+
+
+def __command():
+    setup_logging()
+    get_cached_settings().raise_if_mode_type_prod()
+    get_cached_sqlalchemy_db().reinit()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/remove_operations.py

@@ -0,0 +1,13 @@
+from business_service.remove_operations import remove_operations
+from core.settings import get_cached_settings
+from core.util import setup_logging
+
+
+def __command():
+    setup_logging()
+    get_cached_settings().raise_if_mode_type_prod()
+    remove_operations()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/remove_story_logs.py

@@ -0,0 +1,16 @@
+from core.settings import get_cached_settings
+from core.util import setup_logging
+from sqlalchemy_db.sqlalchemy_db import get_cached_sqlalchemy_db
+from sqlalchemy_db.sqlalchemy_model import StoryLogDBM
+
+
+def __command():
+    setup_logging()
+    get_cached_settings().raise_if_mode_type_prod()
+    with get_cached_sqlalchemy_db().new_session() as session:
+        session.query(StoryLogDBM).delete()
+        session.commit()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/rm_all_records_in_json_db.py

@@ -0,0 +1,13 @@
+from core.settings import get_cached_settings
+from core.util import setup_logging
+from json_db.json_db import get_cached_json_db
+
+
+def __command():
+    setup_logging()
+    get_cached_settings().raise_if_mode_type_prod()
+    get_cached_json_db().rm_all_records()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/{_arpakit_project_template/src/core/_show_settings.py → _arpakit_project_template_v_1/command/show_settings.py}

@@ -1,10 +1,10 @@
 from arpakitlib.ar_json_util import safely_transfer_obj_to_json_str
-from src.core.settings import get_cached_settings
+from core.settings import get_cached_settings
 
 
-def _check_settings():
+def __command():
     print(safely_transfer_obj_to_json_str(get_cached_settings().model_dump(mode="json")))
 
 
 if __name__ == '__main__':
-    _check_settings()
+    __command()

arpakitlib/{_arpakit_project_template/src/api/_start_api_with_reload.py → _arpakit_project_template_v_1/command/start_api_with_reload.py}

@@ -1,13 +1,13 @@
 import uvicorn
 
-from src.core.settings import get_cached_settings
-from src.core.util import setup_logging
+from core.settings import get_cached_settings
+from core.util import setup_logging
 
 
-def _start_api_for_dev_with_reload():
+def __command():
     setup_logging()
     uvicorn.run(
-        "src.api.asgi:app",
+        "api.asgi:app",
         port=get_cached_settings().api_port,
         host="localhost",
         workers=1,
@@ -16,4 +16,4 @@ def _start_api_for_dev_with_reload():
 
 
 if __name__ == '__main__':
-    _start_api_for_dev_with_reload()
+    __command()

arpakitlib/{_arpakit_project_template/src/api/_start_api_without_reload.py → _arpakit_project_template_v_1/command/start_api_without_reload.py}

@@ -1,13 +1,13 @@
 import uvicorn
 
-from src.core.settings import get_cached_settings
-from src.core.util import setup_logging
+from core.settings import get_cached_settings
+from core.util import setup_logging
 
 
-def _start_api_for_dev_without_reload():
+def __command():
     setup_logging()
     uvicorn.run(
-        "src.api.asgi:app",
+        "api.asgi:app",
         port=get_cached_settings().api_port,
         host="localhost",
         workers=1,
@@ -16,4 +16,4 @@ def _start_api_for_dev_without_reload():
 
 
 if __name__ == '__main__':
-    _start_api_for_dev_without_reload()
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/start_async_operation_executor_worker.py

@@ -0,0 +1,14 @@
+import asyncio
+
+from core.util import setup_logging
+from operation_execution.operation_executor_worker import create_operation_executor_worker
+
+
+def __command():
+    setup_logging()
+    worker = create_operation_executor_worker()
+    asyncio.run(worker.async_safe_run())
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/start_async_scheduled_operation_creator_worker.py

@@ -0,0 +1,14 @@
+import asyncio
+
+from core.util import setup_logging
+from operation_execution.scheduled_operation_creator_worker import create_scheduled_operation_creator_worker
+
+
+async def __command():
+    setup_logging()
+    worker = create_scheduled_operation_creator_worker()
+    await worker.async_safe_run()
+
+
+if __name__ == '__main__':
+    asyncio.run(__command())

arpakitlib/_arpakit_project_template_v_1/command/start_sync_operation_executor_worker.py

@@ -0,0 +1,15 @@
+from core.util import setup_logging
+from operation_execution.operation_executor_worker import OperationExecutorWorker
+from sqlalchemy_db.sqlalchemy_db import get_cached_sqlalchemy_db
+
+
+def __command():
+    setup_logging()
+    worker = OperationExecutorWorker(
+        sqlalchemy_db=get_cached_sqlalchemy_db(),
+    )
+    worker.sync_safe_run()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/start_sync_operation_executor_workers.py

@@ -0,0 +1,22 @@
+from arpakitlib.ar_base_worker_util import safe_run_workers_in_background, SafeRunInBackgroundModes
+from core.util import setup_logging
+from operation_execution.operation_executor_worker import OperationExecutorWorker
+from sqlalchemy_db.sqlalchemy_db import get_cached_sqlalchemy_db
+
+
+def __command():
+    setup_logging()
+    workers = []
+    for i in range(int(input("amount of workers: "))):
+        workers.append(OperationExecutorWorker(
+            sqlalchemy_db=get_cached_sqlalchemy_db(),
+        ))
+    safe_run_workers_in_background(
+        workers=workers,
+        mode=SafeRunInBackgroundModes.thread
+    )
+    input("press to close")
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/command/start_sync_scheduled_operation_creator_worker.py

@@ -0,0 +1,12 @@
+from core.util import setup_logging
+from operation_execution.scheduled_operation_creator_worker import create_scheduled_operation_creator_worker
+
+
+def __command():
+    setup_logging()
+    worker = create_scheduled_operation_creator_worker()
+    worker.sync_safe_run()
+
+
+if __name__ == '__main__':
+    __command()

arpakitlib/_arpakit_project_template_v_1/core/cache_file_storage_in_dir.py

@@ -0,0 +1,23 @@
+from functools import lru_cache
+
+from arpakitlib.ar_file_storage_in_dir_util import FileStorageInDir
+from core.settings import get_cached_settings
+
+
+def create_cache_file_storage_in_dir() -> FileStorageInDir | None:
+    if get_cached_settings().cache_dirpath is None:
+        return None
+    return FileStorageInDir(dirpath=get_cached_settings().cache_dirpath)
+
+
+@lru_cache()
+def get_cached_cache_file_storage_in_dir() -> FileStorageInDir | None:
+    return create_cache_file_storage_in_dir()
+
+
+def __example():
+    print(get_cached_cache_file_storage_in_dir().dirpath)
+
+
+if __name__ == '__main__':
+    __example()

arpakitlib/_arpakit_project_template_v_1/core/const.py

@@ -0,0 +1,33 @@
+import asyncio
+import os
+import pathlib
+
+from arpakitlib.ar_enumeration_util import Enumeration
+from arpakitlib.ar_json_util import safely_transfer_obj_to_json_str
+
+
+class ProjectPaths(Enumeration):
+    base_dirpath: str = str(pathlib.Path(__file__).parent.parent)
+
+    env_filepath: str = os.path.join(base_dirpath, ".env")
+
+    resource_dirpath: str = os.path.join(base_dirpath, "resource")
+
+    static_dirpath: str = os.path.join(resource_dirpath, "static")
+
+    templates_dirpath: str = os.path.join(resource_dirpath, "templates")
+
+    arpakit_lib_project_template_filepath: str = os.path.join(base_dirpath, "arpakitlib_project_template.json")
+
+
+def __example():
+    print(safely_transfer_obj_to_json_str(ProjectPaths.key_to_value()))
+
+
+async def __async_example():
+    pass
+
+
+if __name__ == '__main__':
+    __example()
+    asyncio.run(__async_example())

arpakitlib/_arpakit_project_template_v_1/core/dump_file_storage_in_dir.py

@@ -0,0 +1,23 @@
+from functools import lru_cache
+
+from arpakitlib.ar_file_storage_in_dir_util import FileStorageInDir
+from core.settings import get_cached_settings
+
+
+def create_dump_file_storage_in_dir() -> FileStorageInDir | None:
+    if get_cached_settings().dump_dirpath is None:
+        return None
+    return FileStorageInDir(dirpath=get_cached_settings().dump_dirpath)
+
+
+@lru_cache()
+def get_cached_dump_file_storage_in_dir() -> FileStorageInDir | None:
+    return create_dump_file_storage_in_dir()
+
+
+def __example():
+    print(get_cached_dump_file_storage_in_dir().dirpath)
+
+
+if __name__ == '__main__':
+    __example()

arpakitlib/_arpakit_project_template_v_1/core/jinja2_templates.py

@@ -0,0 +1,14 @@
+from functools import lru_cache
+
+from fastapi.templating import Jinja2Templates
+
+from core.const import ProjectPaths
+
+
+def create_jinja2_templates() -> Jinja2Templates:
+    return Jinja2Templates(directory=ProjectPaths.templates_dirpath)
+
+
+@lru_cache()
+def get_cached_jinja2_templates() -> Jinja2Templates:
+    return create_jinja2_templates()