To fix Sec builder doc_generator failure and requirements issues

changelogs/fragments/doc_generator_fix.yaml

@@ -0,0 +1,5 @@
+---
+bugfixes:
+  - To fix the doc_generator issue for secbuity RM builder using OpenAPI JSON file.
+  - https://github.com/ansible-community/ansible.content_builder/issues/28
+  - https://github.com/ansible-community/ansible.content_builder/issues/29

requirements.txt

@@ -2,3 +2,4 @@ black==22.3.0
 Jinja2==3.0.3
 ansible-core
 jsonschema
+oyaml

roles/module_openapi/tasks/main.yaml

@@ -11,7 +11,7 @@
   register: tmp_directory
 
 - name: EXECUTE the python script
-  ansible.builtin.command: python3 doc_generator.py "{{ plugin['rm_swagger_json'] }}"
+  ansible.builtin.command: python3 "{{ role_path }}"/templates/doc_generator.py "{{ plugin['rm_swagger_json'] }}"
     "{{ plugin['api_object_path'] }}"
     "{{ plugin['name'] }}"
     "{{ plugin['module_version'] }}"

roles/module_openapi/templates/doc_generator.py

@@ -881,14 +881,15 @@ def main():
                 }
             )
         else:
-            # post_properties = get_api_param_properties_recursively(
-            #     "$ref", api_object, data, global_var_mgmt_dict
-            # )
-            post_properties = get_api_param_properties_recursively(
-                "schema", api_object, data, global_var_mgmt_dict
-            )
+            if str(sys.argv[6]) == "trendmicro":
+                post_properties = get_api_param_properties_recursively(
+                    "$ref", api_object, data, global_var_mgmt_dict
+                )
+            elif str(sys.argv[6]) == "fortinet":
+                post_properties = get_api_param_properties_recursively(
+                    "schema", api_object, data, global_var_mgmt_dict
+                )
 
-        attribute_map_by_param = {}
         module_name = str(sys.argv[3])
         module_resource = str(sys.argv[5])
         module_version = str(sys.argv[4])