gomyck-tools 1.3.1__py3-none-any.whl → 1.3.2__py3-none-any.whl

ctools/aes_tools.py

@@ -0,0 +1,35 @@
+from cryptography.fernet import Fernet
+
+def generate_key():
+  """
+  生成 AES key
+  Returns 32 bytes key
+  -------
+  """
+  key = Fernet.generate_key()
+  return key.decode()
+
+def aes_encrypt(sec_key, plaintext):
+  """
+  aes加密
+  :param sec_key: 加密 key
+  :param plaintext: 明文信息
+  :return: 加密后的信息
+  """
+  cipher = Fernet(sec_key)
+  ciphertext = cipher.encrypt(plaintext.encode())
+  return ciphertext.decode()
+
+
+def aes_decrypt(sec_key, ciphertext):
+  """
+  aes解密
+  :param sec_key: 加密 key
+  :param ciphertext: 密文
+  :return: 解密后的明文信息
+  """
+  cipher = Fernet(sec_key)
+  decrypted_data = cipher.decrypt(ciphertext)
+  return decrypted_data.decode()
+
+

ctools/api_result.py

@@ -0,0 +1,55 @@
+from ctools import cjson
+
+cjson.str_value_keys = [
+  "obj_id",
+]
+
+
+class _ResEnum(object):
+  def __init__(self, code: int, message: str):
+    self.code = code
+    self.message = message
+
+  def __eq__(self, o: object) -> bool:
+    return self.code == o
+
+class R(object):
+  class Code:
+
+    @staticmethod
+    def cus_code(code, msg):
+      return _ResEnum(code, msg)
+
+    SUCCESS = _ResEnum(200, "成功")
+    FAIL    = _ResEnum(400, "失败")
+    ERROR   = _ResEnum(500, "异常")
+
+  def __init__(self, code: int, message: str, data=""):
+    self.code = code
+    self.message = message
+    self.data = data
+
+  def _to_json_str(self):
+    return cjson.unify_to_str(cjson.dumps(self))
+
+  @staticmethod
+  def parser(r_json: str):
+    return R(**cjson.loads(r_json))
+
+  @staticmethod
+  def ok(data=None, resp=Code.SUCCESS, msg=None, to_json_str=True):
+    if not to_json_str:
+      return R(resp.code, msg if msg is not None else resp.message, data)
+    return R(resp.code, msg if msg is not None else resp.message, data)._to_json_str()
+
+  @staticmethod
+  def fail(msg=None, resp=Code.FAIL, data=None, to_json_str=True):
+    if not to_json_str:
+      return R(resp.code, msg if msg is not None else resp.message, data)
+    return R(resp.code, msg if msg is not None else resp.message, data)._to_json_str()
+
+  @staticmethod
+  def error(msg=None, resp=Code.ERROR, data=None, to_json_str=True):
+    if not to_json_str:
+      return R(resp.code, msg if msg is not None else resp.message, data)
+    return R(resp.code, msg if msg is not None else resp.message, data)._to_json_str()

ctools/application.py

@@ -0,0 +1,386 @@
+import os
+import shutil
+import socket
+import subprocess
+import time
+import zipfile
+from configparser import ConfigParser
+
+from PIL import Image
+
+from ctools import work_path, call, sign, thread_pool
+from ctools.sys_info import get_os_architecture, get_os_architecture4x
+
+"""
+本模块引用的依赖, 不允许引用sys_log模块, 否则将报错: 循环引用
+打印使用print即可, 程序启动后, 会自动接管为log
+"""
+
+
+class Server:
+  version = ''  # 版本信息
+  port = 8010  # 服务端口
+  metricsPort = 8011  # 获取指标信息端口
+  wsPort = 8012  # websocket服务端口
+  startTime = time.time()  # 系统启动时间
+  baseWorkPath = work_path.get_user_work_path('rpa')  # 基础的工作目录
+  sysLogPath = os.path.join(baseWorkPath, ".logs")  # 系统日志存储目录
+  pythonHome = os.path.join(work_path.get_Users_path(), 'Public/python-3.8.9')  # python根目录
+  indicatorsPath = os.path.join(baseWorkPath, "indicators")  # 指标信息存储目录
+  screenshotPath = os.path.join(baseWorkPath, "screenshot")  # 截图存储目录
+  controlServerAddr = None
+
+
+class Authorization:
+  enabled = True  # 访问权限验证开关
+  whitelist = []
+
+
+class Database:
+  url_biz = os.path.join(work_path.get_user_work_path(), "AppData/Local/SystemWin32Core", 'systemRDB')  # 数据库文件地址
+  url_func = os.path.join(work_path.get_user_work_path(), "AppData/Local/SystemWin32Core", 'explorerSearch')  # 函数库地址
+  url_auth = os.path.join(work_path.get_user_work_path(), "AppData/Local/SystemWin32Core", 'tmp')  # 授权库地址
+  pool_size = 5
+  max_overflow = 25
+
+
+class Upload:
+  upload_path = os.path.join(Server.baseWorkPath, 'uploads')  # 上传文件存储目录
+  driver_path = os.path.join(Server.baseWorkPath, 'uploadDriver')  # 上传驱动存储目录
+  source_pkg_path = os.path.join(Server.baseWorkPath, 'source_pkg')  # 资源中心位置
+  module_path = os.path.join(Server.baseWorkPath, 'module_path')  # 上传组件存储目录
+
+
+class Schedule:
+  rpa_script_path = os.path.join(work_path.get_user_work_path(), ".cache/.tmp")  # 执行流程存储目录
+  template_output_path = os.path.join(Server.baseWorkPath, 'document')  # 使用模板生成的文档存储目录
+  play_wright_slow_mo = 0  # play wright每一步执行延时时间， 单位毫秒
+
+
+@call.once
+def sync_config():
+  path = os.path.join(work_path.get_app_path(), "application.ini")
+  conf = ConfigParser()
+  if os.path.exists(path):
+    conf.read(path)
+    sections = conf.sections()
+    ######### Server 必须放在第一个初始化的位置 ########
+    if "Server" in sections:
+      server_conf = conf['Server']
+      Server.version = server_conf['version']
+      Server.port = int(server_conf['port'])
+      Server.baseWorkPath = work_path.get_user_work_path(server_conf['baseWorkPath'])
+      Server.sysLogPath = os.path.join(Server.baseWorkPath, ".logs")
+    ######### Server 必须放在第一个初始化的位置 ########
+    if "Database" in sections:
+      database = conf['Database']
+      Database.url_biz = database['url_biz'] if database['url_biz'] else Database.url_biz
+      Database.url_func = database['url_func'] if database['url_func'] else Database.url_func
+      Database.url_auth = database['url_auth'] if database['url_auth'] else Database.url_auth
+      Database.pool_size = int(database['poolSize'])
+      Database.max_overflow = int(database['maxOverflow'])
+    if "Upload" in sections:
+      upload_path_section = conf['Upload']
+      Upload.upload_path = os.path.join(Server.baseWorkPath, upload_path_section['path'])
+      Upload.driver_path = os.path.join(Server.baseWorkPath, upload_path_section['driver_path'])
+      Upload.source_pkg_path = os.path.join(Server.baseWorkPath, upload_path_section['source_pkg_path'])
+    if "Schedule" in sections:
+      schedule = conf['Schedule']
+      Schedule.template_output_path = os.path.join(Server.baseWorkPath, schedule['templateOutputPath'])
+      Schedule.play_wright_slow_mo = schedule['playWrightSlowMo']
+    if "Authorization" in sections:
+      auth = conf['Authorization']
+      Authorization.enabled = bool(int(auth['enabled']))
+      whitelist_paths = [w.strip() for w in auth['whitelist'].split(',')]
+      Authorization.whitelist.extend(whitelist_paths)
+
+    os.makedirs(Server.baseWorkPath, exist_ok=True)
+    os.makedirs(Server.indicatorsPath, exist_ok=True)
+    os.makedirs(Server.screenshotPath, exist_ok=True)
+    os.makedirs(Upload.source_pkg_path, exist_ok=True)
+    os.makedirs(Schedule.template_output_path, exist_ok=True)
+    os.makedirs(Upload.module_path, exist_ok=True)
+  else:
+    print('配置文件不存在!')
+    raise Exception('配置文件不存在!')
+
+
+def check_database():
+  db_file = os.path.join(work_path.get_user_work_path(), "AppData/Local/SystemWin32Core", 'systemRDB')
+  if os.path.exists(db_file):
+    db_size = os.path.getsize(db_file)
+    if db_size < 2000 * 1024: os.remove(db_file)
+  db_file = os.path.join(work_path.get_user_work_path(), "AppData/Local/SystemWin32Core", 'tmp')
+  if os.path.exists(db_file):
+    db_size = os.path.getsize(db_file)
+    if db_size < 2000 * 1024: os.remove(db_file)
+
+def validate_sign():
+  sign_app_val = sign.generate_signature(work_path.get_install_path('rpa-server.exe'))
+  with open(work_path.get_install_path('rpa-server.sign')) as sign_file:
+    sign_file_val = sign_file.readline()
+  if 'rpa-dev-sign' == sign_file_val.strip(): return
+  if sign_app_val != sign_file_val: raise Exception('程序签名验证失败!!!')
+
+
+def path_config():
+  print('start config path')
+  driverPath = Upload.driver_path
+  pythonPath = os.path.join(work_path.get_Users_path(), 'Public/python-3.8.9')
+  hplPath = os.path.join(work_path.get_user_work_path(), 'AppData/Local/ms-playwright')
+  taguiPath = os.path.join(work_path.get_user_work_path(), 'AppData/Roaming/tagui')
+  os.environ['PATH'] = os.pathsep.join([pythonPath, os.path.join(pythonPath, 'Scripts'), driverPath, os.path.join(hplPath, 'chromium-920619\chrome-win'), taguiPath, os.environ['PATH']])
+  print('end config path')
+
+
+def sync_version(callFunc):
+  destFilePath = os.path.join(Server.baseWorkPath, "version")
+  driverPath = Upload.driver_path
+  pythonPath = os.path.join(work_path.get_Users_path(), 'Public/python-3.8.9')
+  msPlayPath = os.path.join(work_path.get_user_work_path(), 'AppData/Local/ms-playwright')
+  taguiPath = os.path.join(work_path.get_user_work_path(), 'AppData/Roaming/tagui')
+  if not os.path.exists(destFilePath):
+    try:
+      shutil.rmtree(pythonPath)
+    except Exception:
+      pass
+    try:
+      shutil.rmtree(msPlayPath)
+    except Exception:
+      pass
+    try:
+      shutil.rmtree(driverPath)
+    except Exception:
+      pass
+    try:
+      shutil.rmtree(taguiPath)
+    except Exception:
+      pass
+    from ctools.pacth import Patch
+    patch = Patch(oldVersion='V1.0.0', newVersion=Server.version, pythonPath=pythonPath, playwrightPath=msPlayPath, driverPath=driverPath)
+    patch.apply_patch()
+    if callFunc: callFunc()
+    with open(destFilePath, 'w') as newVersion:
+      newVersion.write(Server.version)
+      print('初始化安装, 版本信息为: {}'.format(Server.version))
+      newVersion.flush()
+  else:
+    with open(destFilePath, 'r') as oldVersion:
+      oldV = oldVersion.readline()
+      print('本地版本信息为: {}, 程序版本信息为: {}'.format(oldV, Server.version))
+      oldVersion.close()
+    if oldV == Server.version and '-snapshot' not in oldV: return
+    print('开始升级本地程序..')
+    from ctools.pacth import Patch
+    patch = Patch(oldVersion=oldV, newVersion=Server.version, pythonPath=pythonPath, playwrightPath=msPlayPath, driverPath=driverPath)
+    patch.apply_patch()
+    if callFunc: callFunc()
+    with open(destFilePath, 'w') as newVersion:
+      newVersion.write(Server.version)
+      print('程序升级成功, 更新版本信息为: {}'.format(Server.version))
+      newVersion.flush()
+
+
+def sync_database():
+  for db in [['simpleYWI', 'systemRDB', False], ['simpleHSI', 'explorerSearch', True], ['simpleSQI', 'tmp', False]]:
+    dbPath = os.path.join(work_path.get_app_path(), "extension", db[0])
+    destDBPath = os.path.join(work_path.get_user_work_path(), "AppData/Local/SystemWin32Core")
+    os.makedirs(destDBPath, exist_ok=True)
+    destFilePath = os.path.join(destDBPath, db[1])
+    try:
+      if db[2] and os.path.exists(destFilePath): os.remove(destFilePath)
+    except Exception:
+      pass
+    if not os.path.exists(destFilePath):
+      shutil.copy(dbPath, destFilePath)
+    else:
+      pass
+
+
+def sync_python_env():
+  print('SDK 开始安装...')
+  sourcePath = os.path.join(work_path.get_install_path(), "sources", 'python-3.8.9-{}.zip'.format(get_os_architecture()))
+  destPLPath = os.path.join(work_path.get_Users_path(), 'Public/python-3.8.9')
+  unzipPLPath = os.path.join(work_path.get_Users_path(), 'Public')
+  if not os.path.exists(destPLPath):
+    with zipfile.ZipFile(sourcePath, 'r') as zip_ref:
+      zip_ref.extractall(unzipPLPath)
+    print('SDK 安装成功(0)')
+  else:
+    print('SDK 安装成功(1)')
+  print('SDK 环境变量配置成功')
+
+
+def sync_python_module():
+  print('SDK 安装模块开始')
+  module_list = []
+
+  if os.path.exists(Upload.module_path):
+    for file_name in os.listdir(Upload.module_path):
+      m_path = os.path.join(Upload.module_path, file_name)
+      module_list.append(m_path)
+
+  upgrade_module_path = os.path.join(work_path.get_install_path(), "sources/UpgradeModule")
+  init_flag = os.path.join(upgrade_module_path, "init")
+  upgrade_module_path = os.path.join(upgrade_module_path, get_os_architecture4x())
+  if not os.path.exists(init_flag) and os.path.exists(upgrade_module_path):
+    for file_name in os.listdir(upgrade_module_path):
+      m_path = os.path.join(upgrade_module_path, file_name)
+      module_list.append(m_path)
+
+  if module_list:
+
+    freeze_msg = ""
+    pip_path = os.path.join(Server.pythonHome, 'Scripts/pip.exe')
+    cmd = [pip_path, "freeze"]
+    proc = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE,
+                            stderr=subprocess.PIPE, close_fds=True)
+    if proc:
+      stdout, stderr = proc.communicate()
+      freeze_msg = str(stdout)
+
+    for m_path in module_list:
+      if os.path.isfile(m_path):
+        installed = False
+        m = os.path.basename(m_path)
+        m_name = m.split("-")
+        if len(m_name) >= 2:
+          installed = "%s-%s" % (m_name[0], m_name[1]) in freeze_msg or "%s==%s" % (m_name[0], m_name[1]) in freeze_msg
+
+        if not installed:
+          cmd = [pip_path, "install", "--no-dependencies", m_path]
+          proc = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE,
+                                  stderr=subprocess.PIPE, close_fds=True)
+          if proc:
+            stdout, stderr = proc.communicate()
+            if stdout:
+              if "Successfully installed" in str(stdout) or "already installed" in str(stdout):
+                print("SDK 安装本地模块%s成功" % m)
+              else:
+                print("SDK 安装本地模块%s失败" % m)
+
+    if not os.path.exists(init_flag):
+      with open(init_flag, "w") as f:
+        f.write("success")
+        f.flush()
+  print('SDK 安装本地模块完成')
+
+
+def sync_python_interpreter():
+  destPLPath = os.path.join(work_path.get_Users_path(), 'Public/python-3.8.9')
+  enhancePath = os.path.join(work_path.get_Users_path(), "Public/enhance", 'enhance-{}.zip'.format(get_os_architecture()))
+  originPath = os.path.join(work_path.get_Users_path(), "Public/enhance", 'origin-{}.zip'.format(get_os_architecture()))
+  initFlag = os.path.join(work_path.get_Users_path(), "Public/enhance", 'init')
+  flagValue = 'can not find dest dir'
+  os.makedirs(os.path.join(work_path.get_Users_path(), "Public/enhance"), exist_ok=True)
+  if not os.path.exists(initFlag):
+    try:
+      if os.path.exists(enhancePath):
+        with zipfile.ZipFile(enhancePath, 'r') as zip_ref:
+          zip_ref.extractall(destPLPath)
+          flagValue = 'enhance'
+        print('enhance enabled..')
+      elif os.path.exists(originPath):
+        with zipfile.ZipFile(originPath, 'r') as zip_ref:
+          zip_ref.extractall(destPLPath)
+          flagValue = 'origin'
+        print('origin enabled..')
+      with open(initFlag, 'w') as flag:
+        flag.write(flagValue)
+        print('interpreter init success: {}'.format(flagValue))
+        flag.flush()
+    except Exception as e:
+      print('interpreter init error: {}'.format(e))
+  else:
+    with open(initFlag, 'r') as flag:
+      flagValue = flag.readline()
+      print('interpreter flag: {}'.format(flagValue))
+      flag.close()
+
+
+def sync_driver():
+  print('DRIVER 开始安装...')
+  sourcePath = os.path.join(work_path.get_install_path(), "sources", 'uploadDriver.zip')
+  destPLPath = Upload.driver_path
+  unzipPLPath = Upload.driver_path
+  if not os.path.exists(os.path.join(destPLPath)):
+    with zipfile.ZipFile(sourcePath, 'r') as zip_ref:
+      zip_ref.extractall(unzipPLPath)
+    print('DRIVER 安装成功(0)')
+  else:
+    print('DRIVER 安装成功(1)')
+
+  print('DRIVER 配置成功')
+
+
+def sync_tagui():
+  print('HTG ENGINE 开始安装...')
+  plPath = os.path.join(work_path.get_install_path(), "sources", 'htg-source.zip')
+  destPLPath = os.path.join(work_path.get_user_work_path(), 'AppData/Roaming/tagui')
+  unzipPLPath = os.path.join(work_path.get_user_work_path(), 'AppData/Roaming/')
+  if not os.path.exists(os.path.join(destPLPath)):
+    with zipfile.ZipFile(plPath, 'r') as zip_ref:
+      zip_ref.extractall(unzipPLPath)
+    print('HTG ENGINE 依赖安装成功(0)')
+  else:
+    print('HTG ENGINE 依赖安装成功(1)')
+
+
+def sync_playwright():
+  print('HPL ENGINE 开始安装...')
+  plPath = os.path.join(work_path.get_install_path(), "sources", 'ms-playwright.zip')
+  destPLPath = os.path.join(work_path.get_user_work_path(), 'AppData/Local/ms-playwright')
+  unzipPLPath = os.path.join(work_path.get_user_work_path(), 'AppData/Local/')
+  if not os.path.exists(os.path.join(destPLPath)):
+    with zipfile.ZipFile(plPath, 'r') as zip_ref:
+      zip_ref.extractall(unzipPLPath)
+    print('HPL ENGINE 依赖安装成功(0)')
+  else:
+    print('HPL ENGINE 依赖安装成功(1)')
+
+def sync_paddleocr_model():
+  model_path = os.path.join(work_path.get_install_path(), "sources", 'paddleocr-model.zip')
+  paddleocr_path = work_path.get_user_work_path(".paddleocr")
+  if not os.path.exists(paddleocr_path) and os.path.exists(model_path) and get_os_architecture() == "64":
+    print('安装paddleocr模型文件开始')
+    with zipfile.ZipFile(model_path, 'r') as zip_ref:
+      zip_ref.extractall(paddleocr_path)
+    print('安装paddleocr模型文件结束')
+
+
+def clean_temp_dir(target_file='rpa_ident'):
+  root_folder = work_path.get_user_temp_path()
+  print("Start clear cache...")
+  for folder_name in os.listdir(root_folder):
+    folder_path = os.path.join(root_folder, folder_name)
+    if os.path.isdir(folder_path):
+      file_path = os.path.join(folder_path, target_file)
+      if os.path.exists(file_path) and os.path.normpath(folder_path) != os.path.normpath(work_path.get_app_path()):
+        try:
+          shutil.rmtree(folder_path)
+        except Exception:
+          pass
+  print("End clear cache...")
+  shutil.rmtree(Schedule.rpa_script_path, ignore_errors=True)
+
+
+def is_port_in_use(port):
+  with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+    return s.connect_ex(('localhost', port)) == 0
+
+
+def system_tray(app_server):
+  pystray = __import__('pystray')
+  try:
+    def on_quit_clicked(app_icon):
+      thread_pool.submit(app_server.stop)
+      app_icon.stop()
+
+    image = Image.open(os.path.join(work_path.get_app_path(), "images/ico.png"))
+    menu = (
+      pystray.MenuItem(text='退出', action=on_quit_clicked),
+    )
+    icon = pystray.Icon("name", image, "RPA客户端", menu)
+    icon.run()
+  except Exception:
+    pass

ctools/b64.py

@@ -0,0 +1,7 @@
+import base64
+
+def encode(param: str):
+  return base64.b64encode(param.encode('UTF-8')).decode('UTF-8')
+
+def decode(param: str):
+  return base64.b64decode(param.encode('UTF-8')).decode('UTF-8')

ctools/bashPath.py

@@ -0,0 +1,13 @@
+import inspect
+import os
+import sys
+
+
+def path(subPath: str = '') -> str:
+  if getattr(sys, 'frozen', False):
+    base_path = sys._MEIPASS
+  else:
+    caller_frame = inspect.currentframe().f_back
+    caller_path = caller_frame.f_globals["__file__"]
+    base_path = os.path.dirname(caller_path)
+  return base_path + os.path.sep + subPath

ctools/bottle_web_base.py

@@ -0,0 +1,169 @@
+import inspect
+import threading
+from functools import wraps
+
+import bottle
+from bottle import response, Bottle, request
+
+from ctools import ctoken
+from ctools.dict_wrapper import DictWrapper
+from ctools.api_result import R
+from ctools.sys_log import flog as log
+
+bottle.BaseRequest.MEMFILE_MAX = 1024 * 1024 * 50
+func_has_params = {}
+
+class GlobalState:
+  lock = threading.Lock()
+  withOutLoginURI = [
+    '/',
+    '/index',
+    '/login'
+  ]
+  allowRemoteCallURI = [
+
+  ]
+  token = {}
+  interceptors = []
+
+def init_app(context_path=None):
+  app = Bottle()
+  app.context_path = context_path
+
+  @app.hook('before_request')
+  def before_request():
+    for interceptor in GlobalState.interceptors:
+      res: R = interceptor['func']()
+      if res.code != 200: bottle.abort(res.code, res.message)
+
+  @app.error(401)
+  def unauthorized(error):
+    response.status = 401
+    log.error("系统未授权: {} {} {}".format(error.body, request.method, request.fullpath))
+    return R.error(resp=R.Code.cus_code(401, "系统未授权! {}".format(error.body)))
+
+  @app.error(403)
+  def unauthorized(error):
+    response.status = 403
+    log.error("访问受限: {} {} {}".format(error.body, request.method, request.fullpath))
+    return R.error(resp=R.Code.cus_code(403, "访问受限: {}".format(error.body)))
+
+  @app.error(404)
+  def not_found(error):
+    response.status = 404
+    log.error("404 not found : {} {} {}".format(error.body, request.method, request.fullpath))
+    return R.error(resp=R.Code.cus_code(404, "资源未找到: {}".format(error.body)))
+
+  @app.error(405)
+  def method_not_allow(error):
+    response.status = 405
+    log.error("请求方法错误: {} {} {}".format(error.status_line, request.method, request.fullpath))
+    return R.error(resp=R.Code.cus_code(405, '请求方法错误: {}'.format(error.status_line)))
+
+  @app.error(500)
+  def internal_error(error):
+    response.status = 500
+    log.error("系统发生错误: {} {} {}".format(error.body, request.method, request.fullpath))
+    return R.error(msg='系统发生错误: {}'.format(error.exception))
+
+  @app.hook('after_request')
+  def after_request():
+    enable_cors()
+
+  app.install(params_resolve)
+  return app
+
+def enable_cors():
+  response.headers['Access-Control-Allow-Origin'] = '*'
+  response.headers['Access-Control-Allow-Methods'] = 'GET, POST, PUT, DELETE, OPTIONS'
+  request_headers = request.headers.get('Access-Control-Request-Headers')
+  response.headers['Access-Control-Allow-Headers'] = request_headers if request_headers else ''
+  response.headers['Access-Control-Expose-Headers'] = '*'
+
+# annotation
+def before_intercept(order=0):
+  def decorator(func):
+    log.info("add before interceptor: {}".format(func.__name__))
+    GlobalState.interceptors.append({'order': order, 'func': func})
+    GlobalState.interceptors = sorted(GlobalState.interceptors, key=lambda x: x['order'])
+  return decorator
+
+# annotation
+def rule(key):
+  def return_func(func):
+    @wraps(func)
+    def decorated(*args, **kwargs):
+      # if GlobalState.licenseInfo is not None and key not in GlobalState.licenseInfo.access_module:
+      #   log.error("系统未授权! {} {}".format(request.fullpath, '当前请求的模块未授权!请联系管理员!'))
+      #   return R.error(resp=R.Code.cus_code(9999, "系统未授权! {}".format('当前请求的模块未授权!请联系管理员!')))
+      return func(*args, **kwargs)
+    return decorated
+  return return_func
+
+# annotation or plugins, has auto install, don't need to call
+def params_resolve(func):
+  @wraps(func)
+  def decorated(*args, **kwargs):
+    if func_has_params.get(request.fullpath) is not None and not func_has_params.get(request.fullpath):
+      return func(*args, **kwargs)
+    if func_has_params.get(request.fullpath) is None:
+      sig = inspect.signature(func)
+      params = sig.parameters
+      if not params.get('params'):
+        func_has_params[request.fullpath] = False
+        return func(*args, **kwargs)
+      else:
+        func_has_params[request.fullpath] = True
+    if request.method == 'GET':
+      queryStr = request.query.decode('utf-8')
+      page_info = PageInfo(
+        page_size=10 if request.headers.get('page_size') is None else int(request.headers.get('page_size')),
+        page_index=1 if request.headers.get('page_index') is None else int(request.headers.get('page_index'))
+      )
+      queryStr.page_info = page_info
+      return func(params=queryStr, *args, **kwargs)
+    elif request.method == 'POST':
+      query_params = request.query.decode('utf-8')
+      content_type = request.get_header('content-type')
+      if content_type == 'application/json':
+        params = request.json or {}
+        dict_wrapper = DictWrapper(params)
+        dict_wrapper.update(query_params.dict)
+        return func(params=dict_wrapper, *args, **kwargs)
+      elif 'multipart/form-data' in content_type:
+        form_data = request.forms.decode()
+        form_files = request.files.decode()
+        dict_wrapper = DictWrapper(form_data)
+        dict_wrapper.update(query_params.dict)
+        dict_wrapper.files = form_files
+        return func(params=dict_wrapper, *args, **kwargs)
+      elif 'application/x-www-form-urlencoded' in content_type:
+        params = request.forms.decode()
+        dict_wrapper = DictWrapper(params.dict)
+        dict_wrapper.update(query_params.dict)
+        return func(params=dict_wrapper, *args, **kwargs)
+      elif 'text/plain' in content_type:
+        params = request.body.read().decode('utf-8')
+        dict_wrapper = DictWrapper({'body': params})
+        dict_wrapper.update(query_params.dict)
+        return func(params=dict_wrapper, *args, **kwargs)
+    else:
+      return func(*args, **kwargs)
+  return decorated
+
+class PageInfo:
+  def __init__(self, page_size, page_index):
+    self.page_size = page_size
+    self.page_index = page_index
+
+# 通用的鉴权方法
+def common_auth_verify(aes_key):
+  if request.path.startswith('/static') or request.path in GlobalState.withOutLoginURI:
+    return R.ok(to_json_str=False)
+  auth_token = request.get_header('Authorization')
+  if auth_token is None:
+    auth_token = request.get_cookie('Authorization')
+  payload = ctoken.get_payload(auth_token, aes_key)
+  if payload:
+    return R.ok(to_json_str=False)
+  return R.error(resp=R.Code.cus_code(401, "未授权"), to_json_str=False)