@autorest/python 5.14.0 → 5.17.0

package/autorest/codegen/__init__.py

@@ -5,39 +5,35 @@
 # --------------------------------------------------------------------------
 import logging
 import sys
-from typing import Dict, Any, Set, Union, List, Type
+from typing import Dict, Any, Union, cast
 from pathlib import Path
 import yaml
 
+
 from .. import Plugin
+from .models.client import Client, Config
 from .models.code_model import CodeModel
-from .models import build_schema
+from .models import build_type
+from .models.request_builder import get_request_builder
 from .models.operation_group import OperationGroup
-from .models.parameter import Parameter
-from .models.parameter_list import GlobalParameterList
-from .models.rest import Rest
 from .serializers import JinjaSerializer
-from .models.credential_schema_policy import CredentialSchemaPolicy, get_credential_schema_policy_type
-from .models.credential_schema import AzureKeyCredentialSchema, TokenCredentialSchema
+
 
 def _build_convenience_layer(yaml_data: Dict[str, Any], code_model: CodeModel) -> None:
     # Create operations
     if code_model.options["show_operations"] and yaml_data.get("operationGroups"):
         code_model.operation_groups = [
-            OperationGroup.from_yaml(code_model, op_group) for op_group in yaml_data["operationGroups"]
+            OperationGroup.from_yaml(op_group, code_model)
+            for op_group in yaml_data["operationGroups"]
         ]
-    if yaml_data.get("schemas"):
-        code_model.add_inheritance_to_models()
+    if yaml_data.get("types"):
         if code_model.options["models_mode"]:
-            code_model.sort_schemas()
+            code_model.sort_model_types()
 
     if code_model.options["show_operations"]:
-        code_model.add_schema_link_to_operation()
-        code_model.generate_single_parameter_from_multiple_content_types_operation()
-        code_model.link_operation_to_request_builder()
         # LRO operation
         code_model.format_lro_operations()
-        code_model.remove_next_operation()
+
 
 def _validate_code_model_options(options: Dict[str, Any]) -> None:
 
@@ -81,7 +77,10 @@ def _validate_code_model_options(options: Dict[str, Any]) -> None:
         )
 
     if options["package_mode"]:
-        if options["package_mode"] not in ("mgmtplane", "dataplane") and not Path(options["package_mode"]).exists():
+        if (
+            options["package_mode"] not in ("mgmtplane", "dataplane")
+            and not Path(options["package_mode"]).exists()
+        ):
             raise ValueError(
                 "--package-mode can only be 'mgmtplane' or 'dataplane' or directory which contains template files"
             )
@@ -92,7 +91,16 @@ def _validate_code_model_options(options: Dict[str, Any]) -> None:
             "Please remove --reformat-next-link from your call for version tolerant generations."
         )
 
+    if options["multiapi"] and options["version_tolerant"]:
+        raise ValueError(
+            "Can not currently generate version tolerant multiapi SDKs. "
+            "We are working on creating a new multiapi SDK for version tolerant and it is not available yet."
+        )
+
+
 _LOGGER = logging.getLogger(__name__)
+
+
 class CodeGenerator(Plugin):
     @staticmethod
     def remove_cloud_errors(yaml_data: Dict[str, Any]) -> None:
@@ -103,7 +111,11 @@ class CodeGenerator(Plugin):
                 i = 0
                 while i < len(operation["exceptions"]):
                     exception = operation["exceptions"][i]
-                    if exception.get("schema") and exception["schema"]["language"]["default"]["name"] == "CloudError":
+                    if (
+                        exception.get("schema")
+                        and exception["schema"]["language"]["default"]["name"]
+                        == "CloudError"
+                    ):
                         del operation["exceptions"][i]
                         i -= 1
                     i += 1
@@ -114,217 +126,144 @@ class CodeGenerator(Plugin):
                     del yaml_data["schemas"]["objects"][i]
                     break
 
-    @staticmethod
-    def _build_exceptions_set(yaml_data: List[Dict[str, Any]]) -> Set[int]:
-        exceptions_set = set()
-        for group in yaml_data:
-            for operation in group["operations"]:
-                if not operation.get("exceptions"):
-                    continue
-                for exception in operation["exceptions"]:
-                    if not exception.get("schema"):
-                        continue
-                    exceptions_set.add(id(exception["schema"]))
-        return exceptions_set
-
     @staticmethod
     def _build_package_dependency() -> Dict[str, str]:
         return {
             "dependency_azure_mgmt_core": "azure-mgmt-core<2.0.0,>=1.3.0",
-            "dependency_azure_core": "azure-core<2.0.0,>=1.20.1",
+            "dependency_azure_core": "azure-core<2.0.0,>=1.23.0",
             "dependency_msrest": "msrest>=0.6.21",
         }
 
-    def _create_code_model(self, yaml_data: Dict[str, Any], options: Dict[str, Union[str, bool]]) -> CodeModel:
+    def _create_code_model(
+        self, yaml_data: Dict[str, Any], options: Dict[str, Union[str, bool]]
+    ) -> CodeModel:
         # Create a code model
 
-        code_model = CodeModel(options=options)
-        if code_model.options['credential']:
-            self._handle_default_authentication_policy(code_model)
-        code_model.module_name = yaml_data["info"]["python_title"]
-        code_model.class_name = yaml_data["info"]["pascal_case_title"]
-        code_model.description = (
-            yaml_data["info"]["description"] if yaml_data["info"].get("description") else ""
-        )
-
-        # Global parameters
-        code_model.global_parameters = GlobalParameterList(
-            code_model,
-            [Parameter.from_yaml(param, code_model=code_model) for param in yaml_data.get("globalParameters", [])],
-        )
-        code_model.global_parameters.code_model = code_model
-
-        # Custom URL
-        code_model.setup_client_input_parameters(yaml_data)
+        code_model = CodeModel(yaml_data, options=options)
+        for type_yaml in yaml_data.get("types", []):
+            build_type(yaml_data=type_yaml, code_model=code_model)
 
-        # Get my namespace
-        namespace = self._autorestapi.get_value("namespace")
-        _LOGGER.debug("Namespace parameter was %s", namespace)
-        if not namespace:
-            namespace = yaml_data["info"]["python_title"]
-        code_model.namespace = namespace
+        code_model.client = Client.from_yaml(yaml_data["client"], code_model)
+        code_model.config = Config.from_yaml(yaml_data["client"], code_model)
 
-        code_model.rest = Rest.from_yaml(yaml_data, code_model=code_model)
-        if yaml_data.get("schemas"):
-            exceptions_set = CodeGenerator._build_exceptions_set(yaml_data=yaml_data["operationGroups"])
-
-            for type_list in yaml_data["schemas"].values():
-                for schema in type_list:
-                    build_schema(yaml_data=schema, exceptions_set=exceptions_set, code_model=code_model)
-            code_model.add_schema_link_to_request_builder()
-            code_model.add_schema_link_to_global_parameters()
+        # Build request builders
+        if yaml_data.get("operationGroups"):
+            for og_group in yaml_data["operationGroups"]:
+                for operation_yaml in og_group["operations"]:
+                    request_builder = get_request_builder(
+                        operation_yaml, code_model=code_model
+                    )
+                    if request_builder.overloads:
+                        code_model.request_builders.extend(request_builder.overloads)  # type: ignore
+                    code_model.request_builders.append(request_builder)
+                    if operation_yaml.get("nextOperation"):
+                        # i am a paging operation and i have a next operation. Make sure to include my next operation
+                        code_model.request_builders.append(
+                            get_request_builder(
+                                operation_yaml["nextOperation"], code_model=code_model
+                            )
+                        )
 
         _build_convenience_layer(yaml_data=yaml_data, code_model=code_model)
-
-        if options["credential"]:
-            code_model.global_parameters.add_credential_global_parameter()
-
         code_model.package_dependency = self._build_package_dependency()
         return code_model
 
-    def _get_credential_scopes(self, credential):
-        credential_scopes_temp = self._autorestapi.get_value("credential-scopes")
-        credential_scopes = credential_scopes_temp.split(",") if credential_scopes_temp else None
-        if credential_scopes and not credential:
-            raise ValueError("--credential-scopes must be used with the --add-credential flag")
-
-        # check to see if user just passes in --credential-scopes with no value
-        if self._autorestapi.get_boolean_value("credential-scopes", False) and not credential_scopes:
-            raise ValueError(
-                "--credential-scopes takes a list of scopes in comma separated format. "
-                "For example: --credential-scopes=https://cognitiveservices.azure.com/.default"
-            )
-        return credential_scopes
-
-    def _initialize_credential_schema_policy(
-        self, code_model: CodeModel, credential_schema_policy: Type[CredentialSchemaPolicy]
-    ) -> CredentialSchemaPolicy:
-        credential_scopes = self._get_credential_scopes(code_model.options['credential'])
-        credential_key_header_name = self._autorestapi.get_value('credential-key-header-name')
-        azure_arm = code_model.options['azure_arm']
-        credential = code_model.options['credential']
-
-        if hasattr(credential_schema_policy, "credential_scopes"):
-            if not credential_scopes:
-                if azure_arm:
-                    credential_scopes = ["https://management.azure.com/.default"]
-                elif credential:
-                    # If add-credential is specified, we still want to add a credential_scopes variable.
-                    # Will make it an empty list so we can differentiate between this case and None
-                    _LOGGER.warning(
-                        "You have default credential policy %s "
-                        "but not the --credential-scopes flag set while generating non-management plane code. "
-                        "This is not recommend because it forces the customer to pass credential scopes "
-                        "through kwargs if they want to authenticate.",
-                        credential_schema_policy.name()
-                    )
-                    credential_scopes = []
-
-            if credential_key_header_name:
-                raise ValueError(
-                    "You have passed in a credential key header name with default credential policy type "
-                    f"{credential_schema_policy.name()}. This is not allowed, since credential key header "
-                    "name is tied with AzureKeyCredentialPolicy. Instead, with this policy it is recommend you "
-                    "pass in --credential-scopes."
-                )
-            return credential_schema_policy(
-                credential=TokenCredentialSchema(async_mode=False),
-                credential_scopes=credential_scopes,
-            )
-        # currently the only other credential policy is AzureKeyCredentialPolicy
-        if credential_scopes:
-            raise ValueError(
-                "You have passed in credential scopes with default credential policy type "
-                "AzureKeyCredentialPolicy. This is not allowed, since credential scopes is tied with "
-                f"{code_model.default_authentication_policy.name()}. Instead, with this policy you must pass in "
-                "--credential-key-header-name."
-            )
-        if not credential_key_header_name:
-            credential_key_header_name = "api-key"
-            _LOGGER.info(
-                "Defaulting the AzureKeyCredentialPolicy header's name to 'api-key'"
-            )
-        return credential_schema_policy(
-            credential=AzureKeyCredentialSchema(),
-            credential_key_header_name=credential_key_header_name,
-        )
-
-    def _handle_default_authentication_policy(self, code_model: CodeModel):
-        credential_schema_policy_name = (
-            self._autorestapi.get_value("credential-default-policy-type") or
-            code_model.default_authentication_policy.name()
-        )
-        credential_schema_policy_type = get_credential_schema_policy_type(credential_schema_policy_name)
-        credential_schema_policy = self._initialize_credential_schema_policy(
-            code_model, credential_schema_policy_type
-        )
-        code_model.credential_schema_policy = credential_schema_policy
-
     def _build_code_model_options(self) -> Dict[str, Any]:
-        """Build en options dict from the user input while running autorest.
-        """
+        """Build en options dict from the user input while running autorest."""
         azure_arm = self._autorestapi.get_boolean_value("azure-arm", False)
-        credential = (
-            self._autorestapi.get_boolean_value("add-credentials", False) or
-            self._autorestapi.get_boolean_value("add-credential", False)
-        )
-
         license_header = self._autorestapi.get_value("header-text")
         if license_header:
             license_header = license_header.replace("\n", "\n# ")
             license_header = (
-                "# --------------------------------------------------------------------------\n# " + license_header
+                "# --------------------------------------------------------------------------\n# "
+                + license_header
             )
             license_header += "\n# --------------------------------------------------------------------------"
 
-        low_level_client = self._autorestapi.get_boolean_value("low-level-client", False)
-        version_tolerant = self._autorestapi.get_boolean_value("version-tolerant", False)
-        show_operations = self._autorestapi.get_boolean_value("show-operations", not low_level_client)
-        models_mode_default = "none" if low_level_client or version_tolerant else "msrest"
-        python3_only = self._autorestapi.get_boolean_value("python3-only", low_level_client or version_tolerant)
+        low_level_client = cast(
+            bool, self._autorestapi.get_boolean_value("low-level-client", False)
+        )
+        version_tolerant = cast(
+            bool, self._autorestapi.get_boolean_value("version-tolerant", False)
+        )
+        show_operations = self._autorestapi.get_boolean_value(
+            "show-operations", not low_level_client
+        )
+        models_mode_default = (
+            "none" if low_level_client or version_tolerant else "msrest"
+        )
+        python3_only = cast(
+            bool,
+            self._autorestapi.get_boolean_value(
+                "python3-only", low_level_client or version_tolerant
+            ),
+        )
 
         options: Dict[str, Any] = {
             "azure_arm": azure_arm,
-            "credential": credential,
-            "head_as_boolean": self._autorestapi.get_boolean_value("head-as-boolean", False),
+            "head_as_boolean": self._autorestapi.get_boolean_value(
+                "head-as-boolean", False
+            ),
             "license_header": license_header,
-            "keep_version_file": self._autorestapi.get_boolean_value("keep-version-file", False),
+            "keep_version_file": self._autorestapi.get_boolean_value(
+                "keep-version-file", False
+            ),
             "no_async": self._autorestapi.get_boolean_value("no-async", False),
-            "no_namespace_folders": self._autorestapi.get_boolean_value("no-namespace-folders", False),
-            "basic_setup_py": self._autorestapi.get_boolean_value("basic-setup-py", False),
+            "no_namespace_folders": self._autorestapi.get_boolean_value(
+                "no-namespace-folders", False
+            ),
+            "basic_setup_py": self._autorestapi.get_boolean_value(
+                "basic-setup-py", False
+            ),
             "package_name": self._autorestapi.get_value("package-name"),
             "package_version": self._autorestapi.get_value("package-version"),
-            "client_side_validation": self._autorestapi.get_boolean_value("client-side-validation", False),
+            "client_side_validation": self._autorestapi.get_boolean_value(
+                "client-side-validation", False
+            ),
             "tracing": self._autorestapi.get_boolean_value("trace", show_operations),
             "multiapi": self._autorestapi.get_boolean_value("multiapi", False),
-            "polymorphic_examples": self._autorestapi.get_value("polymorphic-examples") or 5,
-            "models_mode": (self._autorestapi.get_value("models-mode") or models_mode_default).lower(),
+            "polymorphic_examples": self._autorestapi.get_value("polymorphic-examples")
+            or 5,
+            "models_mode": (
+                self._autorestapi.get_value("models-mode") or models_mode_default
+            ).lower(),
             "builders_visibility": self._autorestapi.get_value("builders-visibility"),
             "show_operations": show_operations,
             "show_send_request": self._autorestapi.get_boolean_value(
                 "show-send-request", low_level_client or version_tolerant
             ),
             "only_path_and_body_params_positional": self._autorestapi.get_boolean_value(
-                "only-path-and-body-params-positional", low_level_client or version_tolerant
+                "only-path-and-body-params-positional",
+                low_level_client or version_tolerant,
             ),
             "add_python3_operation_files": self._autorestapi.get_boolean_value(
-                "add-python3-operation-files", python3_only and not low_level_client
+                "add-python3-operation-files",
+                python3_only and not (low_level_client or version_tolerant),
             ),
             "version_tolerant": version_tolerant,
             "low_level_client": low_level_client,
-            "combine_operation_files": self._autorestapi.get_boolean_value("combine-operation-files", version_tolerant),
+            "combine_operation_files": self._autorestapi.get_boolean_value(
+                "combine-operation-files", version_tolerant
+            ),
             "python3_only": python3_only,
             "package_mode": self._autorestapi.get_value("package-mode"),
             "package_pprint_name": self._autorestapi.get_value("package-pprint-name"),
-            "package_configuration": self._autorestapi.get_value("package-configuration"),
+            "package_configuration": self._autorestapi.get_value(
+                "package-configuration"
+            ),
             "default_optional_constants_to_none": self._autorestapi.get_boolean_value(
-                "default-optional-constants-to-none", low_level_client or version_tolerant
+                "default-optional-constants-to-none",
+                low_level_client or version_tolerant,
+            ),
+            "reformat_next_link": self._autorestapi.get_boolean_value(
+                "reformat-next-link", not version_tolerant
             ),
-            "reformat_next_link": self._autorestapi.get_boolean_value("reformat-next-link", not version_tolerant)
         }
 
         if options["builders_visibility"] is None:
-            options["builders_visibility"] = "public" if low_level_client else "embedded"
+            options["builders_visibility"] = (
+                "public" if low_level_client else "embedded"
+            )
         else:
             options["builders_visibility"] = options["builders_visibility"].lower()
 
@@ -336,7 +275,6 @@ class CodeGenerator(Plugin):
 
         # Force some options in ARM MODE:
         if azure_arm:
-            options["credential"] = True
             options["head_as_boolean"] = True
         return options
 
@@ -347,7 +285,16 @@ class CodeGenerator(Plugin):
         if "code-model-v4-no-tags.yaml" not in inputs:
             raise ValueError("code-model-v4-no-tags.yaml must be a possible input")
 
-        file_content = self._autorestapi.read_file("code-model-v4-no-tags.yaml")
+        if self._autorestapi.get_value("input-yaml"):
+            input_yaml = self._autorestapi.get_value("input-yaml")
+            file_content = self._autorestapi.read_file(input_yaml)
+        else:
+            inputs = self._autorestapi.list_inputs()
+            _LOGGER.debug("Possible Inputs: %s", inputs)
+            if "code-model-v4-no-tags.yaml" not in inputs:
+                raise ValueError("code-model-v4-no-tags.yaml must be a possible input")
+
+            file_content = self._autorestapi.read_file("code-model-v4-no-tags.yaml")
 
         # Parse the received YAML
         yaml_data = yaml.safe_load(file_content)
@@ -366,9 +313,13 @@ class CodeGenerator(Plugin):
 
 
 def main(yaml_model_file: str) -> None:
-    from ..jsonrpc.localapi import LocalAutorestAPI  # pylint: disable=import-outside-toplevel
+    from ..jsonrpc.localapi import (  # pylint: disable=import-outside-toplevel
+        LocalAutorestAPI,
+    )
 
-    code_generator = CodeGenerator(autorestapi=LocalAutorestAPI(reachable_files=[yaml_model_file]))
+    code_generator = CodeGenerator(
+        autorestapi=LocalAutorestAPI(reachable_files=[yaml_model_file])
+    )
     if not code_generator.process():
         raise SystemExit("Process didn't finish gracefully")