From 5967b1aeed5e8686c586e4dd8df2df5f7170a487 Mon Sep 17 00:00:00 2001
From: han0 <wslshanlin@sina.com>
Date: Wed, 22 Feb 2023 15:31:12 +0800
Subject: [PATCH] feat:

---
 nc_http/core/documents/__init__.py       |  46 ++++++++++++++
 nc_http/core/documents/api/__init__.py   |   9 +++
 nc_http/core/documents/api/builder.py    |  18 ++++++
 nc_http/core/documents/api/creator.py    |  76 +++++++++++++++++++++++
 nc_http/core/documents/api/template.docx | Bin 0 -> 13075 bytes
 5 files changed, 149 insertions(+)
 create mode 100644 nc_http/core/documents/__init__.py
 create mode 100644 nc_http/core/documents/api/__init__.py
 create mode 100644 nc_http/core/documents/api/builder.py
 create mode 100644 nc_http/core/documents/api/creator.py
 create mode 100644 nc_http/core/documents/api/template.docx

diff --git a/nc_http/core/documents/__init__.py b/nc_http/core/documents/__init__.py
new file mode 100644
index 0000000..3867fc7
--- /dev/null
+++ b/nc_http/core/documents/__init__.py
@@ -0,0 +1,46 @@
+# 重构内容：
+# 1.文档文件通过 docxtpl 模版文件生成
+# 2.数据库文档数据来源为数据库系统信息查询
+#   Oracle
+#   Mysql
+# 3.API 文档数据来源 swagger json 接口
+
+
+class DocumentCreator:
+    has_catalog = True
+
+    def __init__(self, *args, **kwargs):
+        pass
+
+    def create_cover(self):
+        pass
+
+    def init_catalog(self):
+        pass
+
+    def create_catalog(self):
+        pass
+
+    def create_content(self):
+        pass
+
+    def create(self):
+        self.create_cover()
+        self.init_catalog()
+        self.create_content()
+        self.create_catalog()
+
+
+class DocDataBuilder:
+    def __init__(self, *args, **kwargs):
+        self._data = None
+
+    def generate(self):
+        yield
+
+    def clean(self, item):
+        return item
+
+    @property
+    def data(self):
+        return self._data
diff --git a/nc_http/core/documents/api/__init__.py b/nc_http/core/documents/api/__init__.py
new file mode 100644
index 0000000..8214029
--- /dev/null
+++ b/nc_http/core/documents/api/__init__.py
@@ -0,0 +1,9 @@
+from nc_http.core.documents.api.builder import ApiDocDataBuilder
+from nc_http.core.documents.api.creator import ApiDocumentCreator
+
+if __name__ == '__main__':
+    _builder = ApiDocDataBuilder(swagger_json_url='http://localhost:7027/apispec_1.json')
+    creator = ApiDocumentCreator(
+        builder=_builder, filename='text.docx', meta={'number_prefix': '3.1.'}, template='./template.docx'
+    )
+    creator.create()
diff --git a/nc_http/core/documents/api/builder.py b/nc_http/core/documents/api/builder.py
new file mode 100644
index 0000000..706023c
--- /dev/null
+++ b/nc_http/core/documents/api/builder.py
@@ -0,0 +1,18 @@
+import json
+
+import requests
+
+from nc_http.core.documents import DocDataBuilder
+
+
+class ApiDocDataBuilder(DocDataBuilder):
+    def __init__(self, swagger_json_url, *args, **kwargs):
+        self.swagger_json_url = swagger_json_url
+        super().__init__(*args, **kwargs)
+
+    @property
+    def data(self):
+        if self._data is None:
+            data = json.loads(requests.get(self.swagger_json_url).content)
+            self._data = data
+        return self._data
diff --git a/nc_http/core/documents/api/creator.py b/nc_http/core/documents/api/creator.py
new file mode 100644
index 0000000..c8036f0
--- /dev/null
+++ b/nc_http/core/documents/api/creator.py
@@ -0,0 +1,76 @@
+from docxtpl import DocxTemplate
+
+from nc_http.core.documents import DocumentCreator
+
+
+class ApiDocumentCreator(DocumentCreator):
+    definition_map = {}
+
+    def __init__(self, builder, filename, meta, template=None, **kwargs):
+        self.builder = builder
+        self.filename = filename
+        self.meta = meta
+        self.template = template or r'./trash/documents/api/template.docx'
+        self.api_description = None
+        super().__init__(**kwargs)
+
+    def parse_api(self):
+        api = self.builder.data
+
+        for definition_name, definition in api['definitions'].items():
+            # print(definition)
+            definition_content = {}
+            if definition.get('type') == 'object':
+                definition_content = definition['properties']
+            elif definition.get('type') == 'array':
+                definition_content = definition['items'].get('properties', {})
+
+            # print(definition_content)
+            self.definition_map[definition_name] = definition_content
+
+        api_description = {}
+        for path, methods in api['paths'].items():
+            '''
+            path_content: {
+                'get': {
+                    'parameters': [
+                        {
+                            'default': '/u255.jpeg',
+                             'description': '文件 key',
+                             'in': 'path',
+                             'name': 'key',
+                             'required': True,
+                             'type': 'string'
+                         }
+                    ],
+                    'responses': {
+                        '200': {'description': '文件','schema': {'type': 'file'}}
+                    },
+                    'security': [{'Bearer': []}],
+                    'summary': '获取文件',
+                    'tags': ['文件']
+                }
+            }
+            '''
+            for method, content in methods.items():
+                tag = content['tags'][0]
+                content['path'] = path
+                content['method'] = method
+                api_description.setdefault(tag, [])
+                api_description[tag].append(content)
+
+        self.api_description = api_description
+
+    def create_content(self):
+        self.parse_api()
+
+        tpl = DocxTemplate(self.template)
+
+        context = {
+            'api_description': self.api_description,
+            'definition_map': self.definition_map,
+            'table_fields': ['参数名', '必选', '类型', '位置', '说明'],
+        }
+
+        tpl.render(context)
+        tpl.save('text.docx')
diff --git a/nc_http/core/documents/api/template.docx b/nc_http/core/documents/api/template.docx
new file mode 100644
index 0000000000000000000000000000000000000000..2e8d117515146febdfd2876dbcb6605deb613083
GIT binary patch
literal 13075
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

literal 0
HcmV?d00001