@autorest/python 5.15.0 → 5.16.0

package/autorest/codegen/serializers/__init__.py

@@ -9,12 +9,7 @@ from jinja2 import PackageLoader, Environment, FileSystemLoader, StrictUndefined
 from autorest.codegen.models.operation_group import OperationGroup
 
 from ...jsonrpc import AutorestAPI
-from ..models import (
-    CodeModel,
-    OperationGroup,
-    RequestBuilder,
-    TokenCredentialSchema
-)
+from ..models import CodeModel, OperationGroup, RequestBuilder, TokenCredentialSchema
 from .enum_serializer import EnumSerializer
 from .general_serializer import GeneralSerializer
 from .model_generic_serializer import ModelGenericSerializer
@@ -23,7 +18,11 @@ from .model_python3_serializer import ModelPython3Serializer
 from .operations_init_serializer import OperationsInitSerializer
 from .operation_groups_serializer import OperationGroupsSerializer
 from .metadata_serializer import MetadataSerializer
-from .rest_serializer import RestPython3Serializer, RestGenericSerializer, RestSerializer
+from .request_builders_serializer import (
+    RequestBuildersPython3Serializer,
+    RequestBuildersGenericSerializer,
+    RequestBuildersSerializer,
+)
 from .patch_serializer import PatchSerializer
 
 __all__ = [
@@ -39,10 +38,8 @@ _PACKAGE_FILES = [
     "setup.py.jinja2",
 ]
 
-_REGENERATE_FILES = {
-    "setup.py",
-    "MANIFEST.in"
-}
+_REGENERATE_FILES = {"setup.py", "MANIFEST.in"}
+
 
 class JinjaSerializer:
     def __init__(self, autorestapi: AutorestAPI, code_model: CodeModel) -> None:
@@ -51,7 +48,9 @@ class JinjaSerializer:
 
     @property
     def has_aio_folder(self) -> bool:
-        return not self.code_model.options["no_async"] and bool(self.code_model.rest.request_builders)
+        return not self.code_model.options["no_async"] and bool(
+            self.code_model.request_builders
+        )
 
     def serialize(self) -> None:
         env = Environment(
@@ -73,53 +72,84 @@ class JinjaSerializer:
         if self.has_aio_folder:
             self._keep_patch_file(namespace_path / Path("aio") / Path("_patch.py"), env)
 
-        if self.code_model.options["models_mode"] and (self.code_model.schemas or self.code_model.enums):
-            self._keep_patch_file(namespace_path / Path("models") / Path("_patch.py"), env)
-        if self.code_model.options["show_operations"] and self.code_model.operation_groups:
+        if self.code_model.options["models_mode"] and (
+            self.code_model.schemas or self.code_model.enums
+        ):
+            self._keep_patch_file(
+                namespace_path / Path("models") / Path("_patch.py"), env
+            )
+        if (
+            self.code_model.options["show_operations"]
+            and self.code_model.operation_groups
+        ):
             self._keep_patch_file(
-                namespace_path / Path(self.code_model.operations_folder_name) / Path("_patch.py"), env
+                namespace_path
+                / Path(self.code_model.operations_folder_name)
+                / Path("_patch.py"),
+                env,
             )
             if self.has_aio_folder:
                 self._keep_patch_file(
-                    namespace_path / Path("aio") / Path(self.code_model.operations_folder_name) / Path("_patch.py"), env
+                    namespace_path
+                    / Path("aio")
+                    / Path(self.code_model.operations_folder_name)
+                    / Path("_patch.py"),
+                    env,
                 )
 
-        self._serialize_and_write_top_level_folder(env=env, namespace_path=namespace_path)
+        self._serialize_and_write_top_level_folder(
+            env=env, namespace_path=namespace_path
+        )
 
-        if self.code_model.rest.request_builders:
+        if self.code_model.request_builders:
             if self.code_model.options["builders_visibility"] != "embedded":
-                self._serialize_and_write_rest_layer(env=env, namespace_path=namespace_path)
+                self._serialize_and_write_rest_layer(
+                    env=env, namespace_path=namespace_path
+                )
             if self.has_aio_folder:
                 self._serialize_and_write_aio_top_level_folder(
-                    env=env, namespace_path=namespace_path,
+                    env=env,
+                    namespace_path=namespace_path,
                 )
 
-        if self.code_model.options["show_operations"] and self.code_model.operation_groups:
-            self._serialize_and_write_operations_folder(env=env, namespace_path=namespace_path)
+        if (
+            self.code_model.options["show_operations"]
+            and self.code_model.operation_groups
+        ):
+            self._serialize_and_write_operations_folder(
+                env=env, namespace_path=namespace_path
+            )
             if self.code_model.options["multiapi"]:
                 self._serialize_and_write_metadata(
                     env=env, namespace_path=namespace_path
                 )
 
-        if self.code_model.options["models_mode"] and (self.code_model.schemas or self.code_model.enums):
-            self._serialize_and_write_models_folder(env=env, namespace_path=namespace_path)
+        if self.code_model.options["models_mode"] and (
+            self.code_model.schemas or self.code_model.enums
+        ):
+            self._serialize_and_write_models_folder(
+                env=env, namespace_path=namespace_path
+            )
         if not self.code_model.options["models_mode"]:
             # keep models file if users ended up just writing a models file
             if self._autorestapi.read_file(namespace_path / Path("models.py")):
                 self._autorestapi.write_file(
-                    namespace_path / Path("models.py"), self._autorestapi.read_file(namespace_path / Path("models.py"))
+                    namespace_path / Path("models.py"),
+                    self._autorestapi.read_file(namespace_path / Path("models.py")),
                 )
 
         if self.code_model.options["package_mode"]:
             self._serialize_and_write_package_files(out_path=namespace_path)
 
-
     def _serialize_and_write_package_files(self, out_path: Path) -> None:
         def _serialize_and_write_package_files_proc(**kwargs: Any):
             for template_name in package_files:
                 file = template_name.replace(".jinja2", "")
                 output_name = out_path / file
-                if not self._autorestapi.read_file(output_name) or file in _REGENERATE_FILES:
+                if (
+                    not self._autorestapi.read_file(output_name)
+                    or file in _REGENERATE_FILES
+                ):
                     template = env.get_template(template_name)
                     render_result = template.render(**kwargs)
                     self._autorestapi.write_file(output_name, render_result)
@@ -129,20 +159,25 @@ class JinjaSerializer:
             try:
                 token_cred = isinstance(
                     self.code_model.credential_model.credential_schema_policy.credential,
-                    TokenCredentialSchema
+                    TokenCredentialSchema,
                 )
             except ValueError:
                 token_cred = False
             version = self.code_model.options["package_version"]
-            if any(x in version for x in ["a", "b", "rc"]) or version[0] == '0':
+            if any(x in version for x in ["a", "b", "rc"]) or version[0] == "0":
                 dev_status = "4 - Beta"
             else:
                 dev_status = "5 - Production/Stable"
             params = {
                 "token_credential": token_cred,
-                "pkgutil_names": [".".join(package_parts[: i + 1]) for i in range(len(package_parts))],
-                "init_names": ["/".join(package_parts[: i + 1]) + "/__init__.py" for i in range(len(package_parts))],
-                "dev_status": dev_status
+                "pkgutil_names": [
+                    ".".join(package_parts[: i + 1]) for i in range(len(package_parts))
+                ],
+                "init_names": [
+                    "/".join(package_parts[: i + 1]) + "/__init__.py"
+                    for i in range(len(package_parts))
+                ],
+                "dev_status": dev_status,
             }
             params.update(self.code_model.options)
             params.update(self.code_model.package_dependency)
@@ -155,38 +190,55 @@ class JinjaSerializer:
         if self.code_model.options["package_mode"] in ("dataplane", "mgmtplane"):
             env = Environment(
                 loader=PackageLoader("autorest.codegen", "templates"),
-                undefined=StrictUndefined)
+                undefined=StrictUndefined,
+            )
             package_files = _PACKAGE_FILES
             _serialize_and_write_package_files_proc(**_prepare_params())
         elif Path(self.code_model.options["package_mode"]).exists():
             env = Environment(
-                loader=FileSystemLoader(str(Path(self.code_model.options["package_mode"]))),
+                loader=FileSystemLoader(
+                    str(Path(self.code_model.options["package_mode"]))
+                ),
                 keep_trailing_newline=True,
-                undefined=StrictUndefined
+                undefined=StrictUndefined,
             )
             package_files = env.list_templates()
             params = self.code_model.options["package_configuration"] or {}
             _serialize_and_write_package_files_proc(**params)
 
-
     def _keep_patch_file(self, path_file: Path, env: Environment):
         if self._autorestapi.read_file(path_file):
-            self._autorestapi.write_file(path_file, self._autorestapi.read_file(path_file))
+            self._autorestapi.write_file(
+                path_file, self._autorestapi.read_file(path_file)
+            )
         else:
-            self._autorestapi.write_file(path_file, PatchSerializer(env=env, code_model=self.code_model).serialize())
+            self._autorestapi.write_file(
+                path_file,
+                PatchSerializer(env=env, code_model=self.code_model).serialize(),
+            )
 
-    def _serialize_and_write_models_folder(self, env: Environment, namespace_path: Path) -> None:
+    def _serialize_and_write_models_folder(
+        self, env: Environment, namespace_path: Path
+    ) -> None:
         # Write the models folder
         models_path = namespace_path / Path("models")
         if self.code_model.schemas:
-            if not self.code_model.options['python3_only']:
+            if not self.code_model.options["python3_only"]:
                 self._autorestapi.write_file(
-                    models_path / Path(f"{self.code_model.get_models_filename(is_python3_file=False)}.py"),
-                    ModelGenericSerializer(code_model=self.code_model, env=env).serialize()
+                    models_path
+                    / Path(
+                        f"{self.code_model.get_models_filename(is_python3_file=False)}.py"
+                    ),
+                    ModelGenericSerializer(
+                        code_model=self.code_model, env=env
+                    ).serialize(),
                 )
             self._autorestapi.write_file(
-                models_path / Path(f"{self.code_model.get_models_filename(is_python3_file=True)}.py"),
-                ModelPython3Serializer(code_model=self.code_model, env=env).serialize()
+                models_path
+                / Path(
+                    f"{self.code_model.get_models_filename(is_python3_file=True)}.py"
+                ),
+                ModelPython3Serializer(code_model=self.code_model, env=env).serialize(),
             )
         if self.code_model.enums:
             self._autorestapi.write_file(
@@ -194,7 +246,8 @@ class JinjaSerializer:
                 EnumSerializer(code_model=self.code_model, env=env).serialize(),
             )
         self._autorestapi.write_file(
-            models_path / Path("__init__.py"), ModelInitSerializer(code_model=self.code_model, env=env).serialize()
+            models_path / Path("__init__.py"),
+            ModelInitSerializer(code_model=self.code_model, env=env).serialize(),
         )
 
     def _serialize_and_write_rest_layer(
@@ -202,55 +255,60 @@ class JinjaSerializer:
     ) -> None:
         rest_path = namespace_path / Path(self.code_model.rest_layer_name)
         operation_group_names = {
-            rb.operation_group_name for rb in self.code_model.rest.request_builders
+            rb.operation_group_name for rb in self.code_model.request_builders
         }
 
         for operation_group_name in operation_group_names:
             request_builders = [
-                r for r in self.code_model.rest.request_builders if r.operation_group_name == operation_group_name
+                r
+                for r in self.code_model.request_builders
+                if r.operation_group_name == operation_group_name
             ]
             self._serialize_and_write_single_rest_layer(
                 env, rest_path, request_builders
             )
         if not "" in operation_group_names:
             self._autorestapi.write_file(
-                rest_path / Path("__init__.py"), self.code_model.options['license_header']
+                rest_path / Path("__init__.py"),
+                self.code_model.options["license_header"],
             )
 
-
     def _serialize_and_write_single_rest_layer(
         self, env: Environment, rest_path: Path, request_builders: List[RequestBuilder]
     ) -> None:
         builder_group_name = request_builders[0].builder_group_name
-        output_path = rest_path / Path(builder_group_name) if builder_group_name else rest_path
+        output_path = (
+            rest_path / Path(builder_group_name) if builder_group_name else rest_path
+        )
         # write generic request builders file
         self._autorestapi.write_file(
             output_path / Path("_request_builders.py"),
-            RestGenericSerializer(
+            RequestBuildersGenericSerializer(
                 code_model=self.code_model, env=env, request_builders=request_builders
-            ).serialize_request_builders()
+            ).serialize_request_builders(),
         )
 
         # write python3 request builders file
         self._autorestapi.write_file(
             output_path / Path("_request_builders_py3.py"),
-            RestPython3Serializer(
+            RequestBuildersPython3Serializer(
                 code_model=self.code_model, env=env, request_builders=request_builders
-            ).serialize_request_builders()
+            ).serialize_request_builders(),
         )
 
         # write rest init file
         self._autorestapi.write_file(
-            output_path / Path("__init__.py"), RestSerializer(
+            output_path / Path("__init__.py"),
+            RequestBuildersSerializer(
                 code_model=self.code_model, env=env, request_builders=request_builders
-            ).serialize_init()
+            ).serialize_init(),
         )
 
     def _serialize_and_write_operations_file(
         self,
         env: Environment,
         namespace_path: Path,
-        operation_group: Optional[OperationGroup] = None
+        operation_group: Optional[OperationGroup] = None,
     ) -> None:
         filename = operation_group.filename if operation_group else "_operations"
         # write first sync file
@@ -258,25 +316,31 @@ class JinjaSerializer:
             code_model=self.code_model,
             env=env,
             async_mode=False,
-            is_python3_file=self.code_model.options['python3_only'],
-            operation_group=operation_group
+            is_python3_file=self.code_model.options["python3_only"],
+            operation_group=operation_group,
         )
         self._autorestapi.write_file(
-            namespace_path / Path(self.code_model.operations_folder_name) / Path(f"{filename}.py"),
+            namespace_path
+            / Path(self.code_model.operations_folder_name)
+            / Path(f"{filename}.py"),
             operation_group_serializer.serialize(),
         )
 
-        if not self.code_model.options['python3_only'] and self.code_model.options["add_python3_operation_files"]:
+        if (
+            not self.code_model.options["python3_only"]
+            and self.code_model.options["add_python3_operation_files"]
+        ):
             # write typed second file if not python 3 only
             operation_group_serializer = OperationGroupsSerializer(
                 code_model=self.code_model,
                 env=env,
                 async_mode=False,
                 is_python3_file=True,
-
             )
             self._autorestapi.write_file(
-                namespace_path / Path(self.code_model.operations_folder_name) / Path(f"{filename}_py3.py"),
+                namespace_path
+                / Path(self.code_model.operations_folder_name)
+                / Path(f"{filename}_py3.py"),
                 operation_group_serializer.serialize(),
             )
 
@@ -287,7 +351,7 @@ class JinjaSerializer:
                 env=env,
                 async_mode=True,
                 is_python3_file=True,
-                operation_group=operation_group
+                operation_group=operation_group,
             )
             self._autorestapi.write_file(
                 (
@@ -303,9 +367,13 @@ class JinjaSerializer:
         self, env: Environment, namespace_path: Path
     ) -> None:
         # write sync operations init file
-        operations_init_serializer = OperationsInitSerializer(code_model=self.code_model, env=env, async_mode=False)
+        operations_init_serializer = OperationsInitSerializer(
+            code_model=self.code_model, env=env, async_mode=False
+        )
         self._autorestapi.write_file(
-            namespace_path / Path(self.code_model.operations_folder_name) / Path("__init__.py"),
+            namespace_path
+            / Path(self.code_model.operations_folder_name)
+            / Path("__init__.py"),
             operations_init_serializer.serialize(),
         )
 
@@ -315,7 +383,10 @@ class JinjaSerializer:
                 code_model=self.code_model, env=env, async_mode=True
             )
             self._autorestapi.write_file(
-                namespace_path / Path("aio") / Path(self.code_model.operations_folder_name) / Path("__init__.py"),
+                namespace_path
+                / Path("aio")
+                / Path(self.code_model.operations_folder_name)
+                / Path("__init__.py"),
                 operations_async_init_serializer.serialize(),
             )
 
@@ -336,80 +407,96 @@ class JinjaSerializer:
         self, namespace_path: Path, general_serializer: GeneralSerializer
     ):
         def _read_version_file(original_version_file_name: str) -> str:
-            return self._autorestapi.read_file(namespace_path / original_version_file_name)
+            return self._autorestapi.read_file(
+                namespace_path / original_version_file_name
+            )
 
         def _write_version_file(original_version_file_name: str) -> None:
             self._autorestapi.write_file(
                 namespace_path / Path("_version.py"),
-                _read_version_file(original_version_file_name)
+                _read_version_file(original_version_file_name),
             )
-        keep_version_file = self.code_model.options['keep_version_file']
+
+        keep_version_file = self.code_model.options["keep_version_file"]
         if keep_version_file and _read_version_file("_version.py"):
             _write_version_file(original_version_file_name="_version.py")
         elif keep_version_file and _read_version_file("version.py"):
             _write_version_file(original_version_file_name="version.py")
-        elif self.code_model.options['package_version']:
+        elif self.code_model.options["package_version"]:
             self._autorestapi.write_file(
                 namespace_path / Path("_version.py"),
-                general_serializer.serialize_version_file()
+                general_serializer.serialize_version_file(),
             )
 
     def _serialize_and_write_top_level_folder(
         self, env: Environment, namespace_path: Path
     ) -> None:
-        general_serializer = GeneralSerializer(code_model=self.code_model, env=env, async_mode=False)
+        general_serializer = GeneralSerializer(
+            code_model=self.code_model, env=env, async_mode=False
+        )
 
         self._autorestapi.write_file(
-            namespace_path / Path("__init__.py"), general_serializer.serialize_init_file()
+            namespace_path / Path("__init__.py"),
+            general_serializer.serialize_init_file(),
         )
         p = namespace_path.parent
         while p != Path("."):
             # write pkgutil init file
             self._autorestapi.write_file(
-                p / Path("__init__.py"), general_serializer.serialize_pkgutil_init_file()
+                p / Path("__init__.py"),
+                general_serializer.serialize_pkgutil_init_file(),
             )
             p = p.parent
 
         # Write the service client
-        if self.code_model.rest.request_builders:
+        if self.code_model.request_builders:
             self._autorestapi.write_file(
                 namespace_path / Path(f"{self.code_model.service_client.filename}.py"),
-                general_serializer.serialize_service_client_file()
+                general_serializer.serialize_service_client_file(),
             )
 
         if self.code_model.need_vendored_code(async_mode=False):
             self._autorestapi.write_file(
                 namespace_path / Path("_vendor.py"),
-                general_serializer.serialize_vendor_file()
+                general_serializer.serialize_vendor_file(),
             )
 
         self._serialize_and_write_version_file(namespace_path, general_serializer)
 
         # write the empty py.typed file
-        self._autorestapi.write_file(namespace_path / Path("py.typed"), "# Marker file for PEP 561.")
+        self._autorestapi.write_file(
+            namespace_path / Path("py.typed"), "# Marker file for PEP 561."
+        )
 
         # Write the config file
-        if self.code_model.rest.request_builders:
+        if self.code_model.request_builders:
             self._autorestapi.write_file(
-                namespace_path / Path("_configuration.py"), general_serializer.serialize_config_file()
+                namespace_path / Path("_configuration.py"),
+                general_serializer.serialize_config_file(),
             )
 
         # Write the setup file
         if self.code_model.options["basic_setup_py"]:
-            self._autorestapi.write_file(Path("setup.py"), general_serializer.serialize_setup_file())
+            self._autorestapi.write_file(
+                Path("setup.py"), general_serializer.serialize_setup_file()
+            )
 
     def _serialize_and_write_aio_top_level_folder(
         self, env: Environment, namespace_path: Path
     ) -> None:
-        aio_general_serializer = GeneralSerializer(code_model=self.code_model, env=env, async_mode=True)
+        aio_general_serializer = GeneralSerializer(
+            code_model=self.code_model, env=env, async_mode=True
+        )
 
         aio_path = namespace_path / Path("aio")
 
         # Write the __init__ file
-        self._autorestapi.write_file(aio_path / Path("__init__.py"), aio_general_serializer.serialize_init_file())
+        self._autorestapi.write_file(
+            aio_path / Path("__init__.py"), aio_general_serializer.serialize_init_file()
+        )
 
         # Write the service client
-        if self.code_model.rest.request_builders:
+        if self.code_model.request_builders:
             self._autorestapi.write_file(
                 aio_path / Path(f"{self.code_model.service_client.filename}.py"),
                 aio_general_serializer.serialize_service_client_file(),
@@ -417,15 +504,19 @@ class JinjaSerializer:
 
         # Write the config file
         self._autorestapi.write_file(
-            aio_path / Path("_configuration.py"), aio_general_serializer.serialize_config_file()
+            aio_path / Path("_configuration.py"),
+            aio_general_serializer.serialize_config_file(),
         )
         if self.code_model.need_vendored_code(async_mode=True):
             self._autorestapi.write_file(
                 aio_path / Path("_vendor.py"),
-                aio_general_serializer.serialize_vendor_file()
+                aio_general_serializer.serialize_vendor_file(),
             )
 
-
-    def _serialize_and_write_metadata(self, env: Environment, namespace_path: Path) -> None:
+    def _serialize_and_write_metadata(
+        self, env: Environment, namespace_path: Path
+    ) -> None:
         metadata_serializer = MetadataSerializer(self.code_model, env)
-        self._autorestapi.write_file(namespace_path / Path("_metadata.json"), metadata_serializer.serialize())
+        self._autorestapi.write_file(
+            namespace_path / Path("_metadata.json"), metadata_serializer.serialize()
+        )