[2020-07-19] 添加wood预设逻辑模块，同时增加freedom预设接口

Author: SystemLight

.editorconfig

@@ -0,0 +1,14 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+charset = utf-8
+end_of_line = crlf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{py, js, jsx, ts, tsx}]
+indent_style = space
+indent_size = 4

docs/ancient.rst

@@ -11,4 +11,5 @@
    ancient/module
    ancient/rig
    ancient/view
-   ancient/boot
+   ancient/wood
+   ancient/boot

docs/ancient/rig.rst

@@ -33,6 +33,14 @@ register
    :undoc-members:
    :show-inheritance:
 
+template
+---------------------------
+
+.. automodule:: ancient.rig.template
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
 utils
 ---------------------------
 

docs/ancient/view.rst

@@ -1,18 +1,10 @@
 ``ancient.view`` --- 视图模块
 ======================================
 
-backstage
+example
 -----------------------------
 
-.. automodule:: ancient.view.backstage
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-reception
------------------------------
-
-.. automodule:: ancient.view.reception
+.. automodule:: ancient.view.example
    :members:
    :undoc-members:
    :show-inheritance:

docs/ancient/wood.rst

@@ -0,0 +1,18 @@
+``ancient.wood`` --- 预设视图模块
+======================================
+
+freedom
+-----------------------------
+
+.. automodule:: ancient.wood.freedom
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+upload
+-----------------------------
+
+.. automodule:: ancient.wood.upload
+   :members:
+   :undoc-members:
+   :show-inheritance:

madtornado/ancient/__init__.py

@@ -28,6 +28,9 @@ def import_view():
     for i in os.listdir("ancient/view"):
         if i.endswith(".py") and i not in exclude_file:
             __import__("ancient.view.{}".format(i[:-3]))
+    for i in os.listdir("ancient/wood"):
+        if i.endswith(".py") and i not in exclude_file:
+            __import__("ancient.wood.{}".format(i[:-3]))
 
 
 import_view()

madtornado/ancient/boot.py

@@ -23,6 +23,7 @@ def boot():
     :return: None
 
     """
+
     print("Boot hook is started")
 
     # 自启动浏览器，需要该功能请取消注释

madtornado/ancient/handlers/dealHandler.py

@@ -4,7 +4,7 @@
 from tornado.web import StaticFileHandler
 
 """
-改模块下包含一些基类，可以通过配置文件控制这些基类的反应行为
+该模块下包含一些基类，可以通过配置文件控制这些基类的反应行为
 """
 
 
@@ -15,31 +15,31 @@ class StaticHandler(StaticFileHandler, Base):
 
     """
 
-    def initialize(self, path: str, default_filename: str = None, prefix: str = None) -> None:
+    def initialize(self, path: str, default_filename: str = None, prefix: str = None, spa_page: str = None) -> None:
         super(StaticHandler, self).initialize(path, default_filename)
         self.prefix = prefix
         self.absolute_path = path  # 缺少这个属性web.py会报错，问题不大
+        self.spa_page = spa_page
 
     # @override
     async def get(self, path, include_body=True):
         """
 
         默认等于StaticFileHandler.get()行为，通过写该方法，对文件进行控制，可以直接在这里编写代码
 
-        结合单页面应用使用，请改写成以下内容，可以替换index.html为自己的单页面::
-
+        """
+        if self.spa_page:
             if not self.prefix:
                 try:
                     await super(StaticHandler, self).get(path, include_body)
                     return
                 except Exception as e:
-                    await super(StaticHandler, self).get("index.html", include_body)
+                    await super(StaticHandler, self).get(self.spa_page, include_body)
                     return
             else:
                 await super(StaticHandler, self).get(path, include_body)
-
-        """
-        await super(StaticHandler, self).get(path, include_body)
+        else:
+            await super(StaticHandler, self).get(path, include_body)
 
 
 class ProxyHandler(Base):
@@ -233,15 +233,15 @@ async def proxy(self):
 class PongHandler(Base):
     """
 
-    有时可能需要测试服务器的服务是否启动，请访问/init，来进行确定
+    有时可能需要测试服务器的服务是否启动，请访问/pong，来进行确定
 
     """
 
     # @override
     async def get(self):
         """
 
-        有时可能需要测试服务器的服务是否启动，请访问/init，来进行确定
+        有时可能需要测试服务器的服务是否启动，请访问/pong，来进行确定
 
         """
         self.throw(200, log_message="connected")
@@ -250,7 +250,7 @@ async def get(self):
     async def post(self):
         """
 
-        有时可能需要测试服务器的服务是否启动，请访问/init，来进行确定
+        有时可能需要测试服务器的服务是否启动，请访问/pong，来进行确定
 
         """
         await self.get()

madtornado/ancient/module/syncFile.py

@@ -159,7 +159,19 @@ def read(self, path: str, auto_close: bool = True) -> Iterable:
             self.read_fp = None
         return
 
-    def is_exist(self, file_name: str) -> bool:
+    @staticmethod
+    def is_exist(path: str) -> bool:
+        """
+
+        判断文件是否存在
+
+        :param path: 路径
+        :return: 布尔值，是否存在
+
+        """
+        return os.path.exists(path)
+
+    def is_safe_exist(self, file_name: str) -> bool:
         """
 
         判断文件是否存在，需要[捕获异常]处理

madtornado/ancient/rig/register.py

@@ -222,7 +222,7 @@ def get_pe8(content: str):
             content = content.replace(i, "_" + i.lower())
         return content.strip("_")
 
-    def route(self, prefix: str = "", url: str = None, urls: list = None, end=False):
+    def route(self, url: str = None, prefix: str = "", urls: list = None, end=False):
         """
 
         ``装饰器`` 添加该装饰器的请求实例，路由路径会被自动注册到路由表中
@@ -236,8 +236,8 @@ def route(self, prefix: str = "", url: str = None, urls: list = None, end=False)
         如果你在配置文件中配置了url_prefix = [] 这是一个列表，会生成一组带前缀的静态文件路由匹配项
         而我们的end=True的路由会放到这些带前缀的静态文件管理路由后面
 
-        :param prefix: 如果提供该内容将在路由中添加一个前缀，这个前缀是在统一路由前缀后面的
         :param url: 路由路径，不填写默认会根据类名生成路径
+        :param prefix: 如果提供该内容将在路由中添加一个前缀，这个前缀是在统一路由前缀后面的
         :param urls: 如果设置该参数，传入一个列表对象，url将不起效果，同时为该类增加多个可匹配的路由
         :param end: 声明该路由是否注册到默认路由后面，系统默认路由参考server.py中的default_route
         :return: None