sera-2 1.1.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

sera/make/make_python_api.py

@@ -4,7 +4,7 @@ from typing import Sequence
 
 from codegen.models import DeferredVar, PredefinedFn, Program, expr, stmt
 from loguru import logger
-from sera.misc import to_snake_case
+from sera.misc import assert_not_null, to_snake_case
 from sera.models import App, DataCollection, Module, Package
 
 
@@ -13,17 +13,25 @@ def make_python_api(app: App, collections: Sequence[DataCollection]):
     app.api.ensure_exists()
     app.api.pkg("routes").ensure_exists()
 
+    # make routes & depdnencies
     dep_pkg = app.api.pkg("dependencies")
+    routes: list[Module] = []
     for collection in collections:
         make_dependency(collection, dep_pkg)
         route = app.api.pkg("routes").pkg(collection.get_pymodule_name())
 
-        get_route, get_route_fn = make_python_get_api(collection, route)
+        controllers = []
+        controllers.append(make_python_get_api(collection, route))
+        controllers.append(make_python_get_by_id_api(collection, route))
+        controllers.append(make_python_has_api(collection, route))
+        controllers.append(make_python_create_api(collection, route))
+        controllers.append(make_python_update_api(collection, route))
 
         program = Program()
         program.import_("__future__.annotations", True)
         program.import_("litestar.Router", True)
-        program.import_(get_route.path + "." + get_route_fn, True)
+        for get_route, get_route_fn in controllers:
+            program.import_(get_route.path + "." + get_route_fn, True)
 
         program.root(
             stmt.LineBreak(),
@@ -42,7 +50,8 @@ def make_python_api(app: App, collections: Sequence[DataCollection]):
                             "route_handlers",
                             PredefinedFn.list(
                                 [
-                                    expr.ExprIdent(get_route_fn),
+                                    expr.ExprIdent(get_route_fn)
+                                    for get_route, get_route_fn in controllers
                                 ]
                             ),
                         ),
@@ -52,6 +61,43 @@ def make_python_api(app: App, collections: Sequence[DataCollection]):
         )
 
         route.module("route").write(program)
+        routes.append(route.module("route"))
+
+    # make the main entry point
+    make_main(app.api, routes)
+
+
+def make_main(target_pkg: Package, routes: Sequence[Module]):
+    outmod = target_pkg.module("app")
+    if outmod.exists():
+        logger.info("`{}` already exists. Skip generation.", outmod.path)
+        return
+
+    program = Program()
+    program.import_("__future__.annotations", True)
+    program.import_("litestar.Litestar", True)
+    for route in routes:
+        program.import_(route.path, False)
+
+    program.root(
+        stmt.LineBreak(),
+        lambda ast: ast.assign(
+            DeferredVar.simple("app"),
+            expr.ExprFuncCall(
+                expr.ExprIdent("Litestar"),
+                [
+                    PredefinedFn.keyword_assignment(
+                        "route_handlers",
+                        PredefinedFn.list(
+                            [expr.ExprIdent(route.path + ".router") for route in routes]
+                        ),
+                    )
+                ],
+            ),
+        ),
+    )
+
+    outmod.write(program)
 
 
 def make_dependency(collection: DataCollection, target_pkg: Package):
@@ -76,7 +122,10 @@ def make_dependency(collection: DataCollection, target_pkg: Package):
     program.root(
         stmt.LineBreak(),
         lambda ast: ast.func(
-            ServiceNameDep, [], expr.ExprIdent(collection.get_service_name())
+            ServiceNameDep,
+            [],
+            expr.ExprIdent(collection.get_service_name()),
+            is_async=True,
         )(
             lambda ast01: ast01.return_(
                 expr.ExprFuncCall(expr.ExprIdent(collection.get_service_name()), [])
@@ -97,10 +146,13 @@ def make_python_get_api(
     program = Program()
     program.import_("__future__.annotations", True)
     program.import_("typing.Annotated", True)
+    program.import_("typing.Sequence", True)
     program.import_("litestar.get", True)
     program.import_("litestar.Request", True)
     program.import_("litestar.params.Parameter", True)
+    program.import_(app.models.db.path + ".base.get_session", True)
     program.import_("litestar.di.Provide", True)
+    program.import_("sqlalchemy.orm.Session", True)
     program.import_(app.config.path + ".ROUTER_DEBUG", True)
     program.import_(
         f"{app.api.path}.dependencies.{collection.get_pymodule_name()}.{ServiceNameDep}",
@@ -111,6 +163,10 @@ def make_python_get_api(
         + f".{collection.get_pymodule_name()}.{collection.get_service_name()}",
         True,
     )
+    program.import_(
+        app.models.data.path + f".{collection.get_pymodule_name()}.{collection.name}",
+        True,
+    )
     program.import_("sera.libs.api_helper.parse_query", True)
 
     func_name = "get_"
@@ -133,7 +189,11 @@ def make_python_get_api(
                                 (
                                     expr.ExprConstant("service"),
                                     expr.ExprIdent(f"Provide({ServiceNameDep})"),
-                                )
+                                ),
+                                (
+                                    expr.ExprConstant("session"),
+                                    expr.ExprIdent(f"Provide(get_session)"),
+                                ),
                             ]
                         ),
                     ),
@@ -187,7 +247,12 @@ def make_python_get_api(
                     "service",
                     expr.ExprIdent(collection.get_service_name()),
                 ),
+                DeferredVar.simple(
+                    "session",
+                    expr.ExprIdent("Session"),
+                ),
             ],
+            return_type=expr.ExprIdent(f"Sequence[{collection.name}]"),
             is_async=True,
         )(
             stmt.SingleExprStatement(
@@ -207,7 +272,8 @@ def make_python_get_api(
                     ],
                 ),
             ),
-            lambda ast12: ast12.return_(
+            lambda ast12: ast12.assign(
+                DeferredVar.simple("result"),
                 expr.ExprFuncCall(
                     expr.ExprIdent("service.get"),
                     [
@@ -230,7 +296,21 @@ def make_python_get_api(
                         PredefinedFn.keyword_assignment(
                             "fields", expr.ExprIdent("fields")
                         ),
+                        PredefinedFn.keyword_assignment(
+                            "session", expr.ExprIdent("session")
+                        ),
                     ],
+                ),
+            ),
+            lambda ast13: ast13.return_(
+                PredefinedFn.map_list(
+                    expr.ExprIdent("result"),
+                    lambda item: expr.ExprFuncCall(
+                        PredefinedFn.attr_getter(
+                            expr.ExprIdent(collection.name), expr.ExprIdent("from_db")
+                        ),
+                        [item],
+                    ),
                 )
             ),
         ),
@@ -240,3 +320,478 @@ def make_python_get_api(
     outmod.write(program)
 
     return outmod, func_name
+
+
+def make_python_get_by_id_api(
+    collection: DataCollection, target_pkg: Package
+) -> tuple[Module, str]:
+    """Make an endpoint for querying resource by id"""
+    app = target_pkg.app
+
+    ServiceNameDep = to_snake_case(f"{collection.name}ServiceDependency")
+
+    program = Program()
+    program.import_("__future__.annotations", True)
+    program.import_("litestar.get", True)
+    program.import_("litestar.status_codes", True)
+    program.import_("litestar.exceptions.HTTPException", True)
+    program.import_("litestar.di.Provide", True)
+    program.import_("sqlalchemy.orm.Session", True)
+    program.import_(app.models.db.path + ".base.get_session", True)
+    program.import_(
+        f"{app.api.path}.dependencies.{collection.get_pymodule_name()}.{ServiceNameDep}",
+        True,
+    )
+    program.import_(
+        app.services.path
+        + f".{collection.get_pymodule_name()}.{collection.get_service_name()}",
+        True,
+    )
+    program.import_(
+        app.models.data.path + f".{collection.get_pymodule_name()}.{collection.name}",
+        True,
+    )
+
+    # assuming the collection has only one class
+    cls = collection.cls
+    id_type = assert_not_null(cls.get_id_property()).datatype.get_python_type().type
+
+    func_name = "get_by_id"
+    program.root(
+        stmt.LineBreak(),
+        stmt.PythonDecoratorStatement(
+            expr.ExprFuncCall(
+                expr.ExprIdent("get"),
+                [
+                    expr.ExprConstant("/{id:%s}" % id_type),
+                    PredefinedFn.keyword_assignment(
+                        "dependencies",
+                        PredefinedFn.dict(
+                            [
+                                (
+                                    expr.ExprConstant("service"),
+                                    expr.ExprIdent(f"Provide({ServiceNameDep})"),
+                                ),
+                                (
+                                    expr.ExprConstant("session"),
+                                    expr.ExprIdent(f"Provide(get_session)"),
+                                ),
+                            ]
+                        ),
+                    ),
+                ],
+            )
+        ),
+        lambda ast10: ast10.func(
+            func_name,
+            [
+                DeferredVar.simple(
+                    "id",
+                    expr.ExprIdent(id_type),
+                ),
+                DeferredVar.simple(
+                    "service",
+                    expr.ExprIdent(collection.get_service_name()),
+                ),
+                DeferredVar.simple(
+                    "session",
+                    expr.ExprIdent("Session"),
+                ),
+            ],
+            return_type=expr.ExprIdent(f"{cls.name}"),
+            is_async=True,
+        )(
+            stmt.SingleExprStatement(expr.ExprConstant("Retrieving record by id")),
+            lambda ast11: ast11.assign(
+                DeferredVar.simple("record"),
+                expr.ExprFuncCall(
+                    expr.ExprIdent("service.get_by_id"),
+                    [
+                        expr.ExprIdent("id"),
+                        expr.ExprIdent("session"),
+                    ],
+                ),
+            ),
+            lambda ast12: ast12.if_(PredefinedFn.is_null(expr.ExprIdent("record")))(
+                lambda ast23: ast23.raise_exception(
+                    expr.StandardExceptionExpr(
+                        expr.ExprIdent("HTTPException"),
+                        [
+                            PredefinedFn.keyword_assignment(
+                                "status_code",
+                                expr.ExprIdent("status_codes.HTTP_404_NOT_FOUND"),
+                            ),
+                            PredefinedFn.keyword_assignment(
+                                "detail",
+                                expr.ExprIdent('f"Record with id {id} not found"'),
+                            ),
+                        ],
+                    )
+                )
+            ),
+            lambda ast13: ast13.return_(
+                expr.ExprFuncCall(
+                    PredefinedFn.attr_getter(
+                        expr.ExprIdent(cls.name), expr.ExprIdent("from_db")
+                    ),
+                    [expr.ExprIdent("record")],
+                )
+            ),
+        ),
+    )
+
+    outmod = target_pkg.module("get_by_id")
+    outmod.write(program)
+
+    return outmod, func_name
+
+
+def make_python_has_api(
+    collection: DataCollection, target_pkg: Package
+) -> tuple[Module, str]:
+    """Make an endpoint for querying resource by id"""
+    app = target_pkg.app
+
+    ServiceNameDep = to_snake_case(f"{collection.name}ServiceDependency")
+
+    program = Program()
+    program.import_("__future__.annotations", True)
+    program.import_("litestar.head", True)
+    program.import_("litestar.status_codes", True)
+    program.import_("litestar.exceptions.HTTPException", True)
+    program.import_("litestar.di.Provide", True)
+    program.import_("sqlalchemy.orm.Session", True)
+    program.import_(app.models.db.path + ".base.get_session", True)
+    program.import_(
+        f"{app.api.path}.dependencies.{collection.get_pymodule_name()}.{ServiceNameDep}",
+        True,
+    )
+    program.import_(
+        app.services.path
+        + f".{collection.get_pymodule_name()}.{collection.get_service_name()}",
+        True,
+    )
+    program.import_(
+        app.models.data.path + f".{collection.get_pymodule_name()}.{collection.name}",
+        True,
+    )
+
+    # assuming the collection has only one class
+    cls = collection.cls
+    id_type = assert_not_null(cls.get_id_property()).datatype.get_python_type().type
+
+    func_name = "has"
+    program.root(
+        stmt.LineBreak(),
+        stmt.PythonDecoratorStatement(
+            expr.ExprFuncCall(
+                expr.ExprIdent("head"),
+                [
+                    expr.ExprConstant("/{id:%s}" % id_type),
+                    PredefinedFn.keyword_assignment(
+                        "status_code",
+                        expr.ExprIdent("status_codes.HTTP_204_NO_CONTENT"),
+                    ),
+                    PredefinedFn.keyword_assignment(
+                        "dependencies",
+                        PredefinedFn.dict(
+                            [
+                                (
+                                    expr.ExprConstant("service"),
+                                    expr.ExprIdent(f"Provide({ServiceNameDep})"),
+                                ),
+                                (
+                                    expr.ExprConstant("session"),
+                                    expr.ExprIdent(f"Provide(get_session)"),
+                                ),
+                            ]
+                        ),
+                    ),
+                ],
+            )
+        ),
+        lambda ast10: ast10.func(
+            func_name,
+            [
+                DeferredVar.simple(
+                    "id",
+                    expr.ExprIdent(id_type),
+                ),
+                DeferredVar.simple(
+                    "service",
+                    expr.ExprIdent(collection.get_service_name()),
+                ),
+                DeferredVar.simple(
+                    "session",
+                    expr.ExprIdent("Session"),
+                ),
+            ],
+            return_type=expr.ExprConstant(None),
+            is_async=True,
+        )(
+            stmt.SingleExprStatement(expr.ExprConstant("Retrieving record by id")),
+            lambda ast11: ast11.assign(
+                DeferredVar.simple("record_exist"),
+                expr.ExprFuncCall(
+                    expr.ExprIdent("service.has_id"),
+                    [
+                        expr.ExprIdent("id"),
+                        expr.ExprIdent("session"),
+                    ],
+                ),
+            ),
+            lambda ast12: ast12.if_(expr.ExprNegation(expr.ExprIdent("record_exist")))(
+                lambda ast23: ast23.raise_exception(
+                    expr.StandardExceptionExpr(
+                        expr.ExprIdent("HTTPException"),
+                        [
+                            PredefinedFn.keyword_assignment(
+                                "status_code",
+                                expr.ExprIdent("status_codes.HTTP_404_NOT_FOUND"),
+                            ),
+                            PredefinedFn.keyword_assignment(
+                                "detail",
+                                expr.ExprIdent('f"Record with id {id} not found"'),
+                            ),
+                        ],
+                    )
+                )
+            ),
+            lambda ast13: ast13.return_(expr.ExprConstant(None)),
+        ),
+    )
+
+    outmod = target_pkg.module("has")
+    outmod.write(program)
+
+    return outmod, func_name
+
+
+def make_python_create_api(collection: DataCollection, target_pkg: Package):
+    """Make an endpoint for creating a resource"""
+    app = target_pkg.app
+
+    ServiceNameDep = to_snake_case(f"{collection.name}ServiceDependency")
+
+    program = Program()
+    program.import_("__future__.annotations", True)
+    program.import_("litestar.post", True)
+    program.import_("litestar.di.Provide", True)
+    program.import_("sqlalchemy.orm.Session", True)
+    program.import_(app.models.db.path + ".base.get_session", True)
+    program.import_(
+        f"{app.api.path}.dependencies.{collection.get_pymodule_name()}.{ServiceNameDep}",
+        True,
+    )
+    program.import_(
+        app.services.path
+        + f".{collection.get_pymodule_name()}.{collection.get_service_name()}",
+        True,
+    )
+    program.import_(
+        app.models.data.path + f".{collection.get_pymodule_name()}.{collection.name}",
+        True,
+    )
+    program.import_(
+        app.models.data.path
+        + f".{collection.get_pymodule_name()}.Upsert{collection.name}",
+        True,
+    )
+
+    # assuming the collection has only one class
+    cls = collection.cls
+    id_type = assert_not_null(cls.get_id_property()).datatype.get_python_type().type
+
+    func_name = "create"
+
+    program.root(
+        stmt.LineBreak(),
+        stmt.PythonDecoratorStatement(
+            expr.ExprFuncCall(
+                expr.ExprIdent("post"),
+                [
+                    expr.ExprConstant("/"),
+                    PredefinedFn.keyword_assignment(
+                        "dependencies",
+                        PredefinedFn.dict(
+                            [
+                                (
+                                    expr.ExprConstant("service"),
+                                    expr.ExprIdent(f"Provide({ServiceNameDep})"),
+                                ),
+                                (
+                                    expr.ExprConstant("session"),
+                                    expr.ExprIdent(f"Provide(get_session)"),
+                                ),
+                            ]
+                        ),
+                    ),
+                ],
+            )
+        ),
+        lambda ast10: ast10.func(
+            func_name,
+            [
+                DeferredVar.simple(
+                    "record",
+                    expr.ExprIdent(f"Upsert{cls.name}"),
+                ),
+                DeferredVar.simple(
+                    "service",
+                    expr.ExprIdent(collection.get_service_name()),
+                ),
+                DeferredVar.simple(
+                    "session",
+                    expr.ExprIdent("Session"),
+                ),
+            ],
+            return_type=expr.ExprIdent(cls.name),
+            is_async=True,
+        )(
+            stmt.SingleExprStatement(expr.ExprConstant("Creating new record")),
+            lambda ast13: ast13.return_(
+                expr.ExprMethodCall(
+                    expr.ExprIdent(cls.name),
+                    "from_db",
+                    [
+                        expr.ExprMethodCall(
+                            expr.ExprIdent("service"),
+                            "create",
+                            [
+                                expr.ExprMethodCall(
+                                    expr.ExprIdent("record"), "to_db", []
+                                ),
+                                expr.ExprIdent("session"),
+                            ],
+                        )
+                    ],
+                )
+            ),
+        ),
+    )
+
+    outmod = target_pkg.module("create")
+    outmod.write(program)
+
+    return outmod, func_name
+
+
+def make_python_update_api(collection: DataCollection, target_pkg: Package):
+    """Make an endpoint for updating resource"""
+    app = target_pkg.app
+
+    ServiceNameDep = to_snake_case(f"{collection.name}ServiceDependency")
+
+    program = Program()
+    program.import_("__future__.annotations", True)
+    program.import_("litestar.put", True)
+    program.import_("litestar.di.Provide", True)
+    program.import_("sqlalchemy.orm.Session", True)
+    program.import_(app.models.db.path + ".base.get_session", True)
+    program.import_(
+        f"{app.api.path}.dependencies.{collection.get_pymodule_name()}.{ServiceNameDep}",
+        True,
+    )
+    program.import_(
+        app.services.path
+        + f".{collection.get_pymodule_name()}.{collection.get_service_name()}",
+        True,
+    )
+    program.import_(
+        app.models.data.path + f".{collection.get_pymodule_name()}.{collection.name}",
+        True,
+    )
+    program.import_(
+        app.models.data.path
+        + f".{collection.get_pymodule_name()}.Upsert{collection.name}",
+        True,
+    )
+
+    # assuming the collection has only one class
+    cls = collection.cls
+    id_prop = assert_not_null(cls.get_id_property())
+    id_type = id_prop.datatype.get_python_type().type
+
+    func_name = "update"
+
+    program.root(
+        stmt.LineBreak(),
+        stmt.PythonDecoratorStatement(
+            expr.ExprFuncCall(
+                expr.ExprIdent("put"),
+                [
+                    expr.ExprConstant("/{id:%s}" % id_type),
+                    PredefinedFn.keyword_assignment(
+                        "dependencies",
+                        PredefinedFn.dict(
+                            [
+                                (
+                                    expr.ExprConstant("service"),
+                                    expr.ExprIdent(f"Provide({ServiceNameDep})"),
+                                ),
+                                (
+                                    expr.ExprConstant("session"),
+                                    expr.ExprIdent(f"Provide(get_session)"),
+                                ),
+                            ]
+                        ),
+                    ),
+                ],
+            )
+        ),
+        lambda ast10: ast10.func(
+            func_name,
+            [
+                DeferredVar.simple(
+                    "id",
+                    expr.ExprIdent(id_type),
+                ),
+                DeferredVar.simple(
+                    "record",
+                    expr.ExprIdent(f"Upsert{cls.name}"),
+                ),
+                DeferredVar.simple(
+                    "service",
+                    expr.ExprIdent(collection.get_service_name()),
+                ),
+                DeferredVar.simple(
+                    "session",
+                    expr.ExprIdent("Session"),
+                ),
+            ],
+            return_type=expr.ExprIdent(cls.name),
+            is_async=True,
+        )(
+            stmt.SingleExprStatement(expr.ExprConstant("Update an existing record")),
+            stmt.SingleExprStatement(
+                PredefinedFn.attr_setter(
+                    expr.ExprIdent("record"),
+                    expr.ExprIdent(id_prop.name),
+                    expr.ExprIdent("id"),
+                )
+            ),
+            lambda ast13: ast13.return_(
+                expr.ExprMethodCall(
+                    expr.ExprIdent(cls.name),
+                    "from_db",
+                    [
+                        expr.ExprMethodCall(
+                            expr.ExprIdent("service"),
+                            "update",
+                            [
+                                expr.ExprMethodCall(
+                                    expr.ExprIdent("record"), "to_db", []
+                                ),
+                                expr.ExprIdent("session"),
+                            ],
+                        )
+                    ],
+                )
+            ),
+        ),
+    )
+
+    outmod = target_pkg.module("update")
+    outmod.write(program)
+
+    return outmod, func_name