enconia-utils 0.1.0__tar.gz

enconia_utils-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Huanai Technology Co., Ltd.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

enconia_utils-0.1.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: enconia-utils
+Version: 0.1.0
+Summary: utils for enconia
+Author-email: "Huanai Technology Co., Ltd" <zhou-jinyuan@foxmail.com>
+License: BSD-3-Clause
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: pytz>=2021.1
+Requires-Dist: deprecated>=1.2.0
+Requires-Dist: oss2>=2.15.0
+Requires-Dist: aliyun-log-python-sdk>=0.8.0
+Requires-Dist: chinese_calendar>=1.6.0
+Dynamic: license-file
+
+# enconia-utils
+
+Enconia 工具包，提供常用的 Python 工具函数集合。
+
+## 安装
+
+```bash
+pip install enconia-utils
+```
+
+## 功能模块
+
+### ID 生成器 (`id_generator`)
+- `get_random_short_id()` - 生成 8 位随机短 ID
+- `get_random_long_id()` - 生成 22 位随机长 ID
+- `get_fix_short_id(base_str)` - 根据输入字符串生成固定的短 ID
+- `get_fix_long_id(base_str)` - 根据输入字符串生成固定的长 ID
+- `get_file_md5(filepath)` - 计算文件 MD5
+
+### 日期工具 (`util_date`)
+- `get_orbit_std_datetime()` - 获取标准格式的当前日期时间
+- `get_orbit_std_date()` - 获取标准格式的当前日期
+- `get_date_range_list_v2(start, end)` - 获取日期范围列表
+- `get_next_day(day, interval)` - 获取下一天
+- `get_next_workday_cn(day)` - 获取下一个中国工作日
+
+### 飞书推送 (`feishu_push`)
+- `FeiShuTalkChatBot` - 飞书机器人消息推送
+
+### 阿里云 SLS 日志 (`aliyun_sls_log`)
+- `send_log_to_sls()` - 发送日志到阿里云 SLS
+
+### 阿里云 OSS (`util_oss`)
+- `OssCloudObjectProvider` - OSS 文件操作（上传、下载、复制、删除等）
+
+### 文件类型映射 (`util_type_mapping`)
+- `get_content_type_4_filename(filename)` - 根据文件名获取 MIME 类型
+- `file2content_type(ext)` - 扩展名转 MIME 类型
+- `content2file_type(mime)` - MIME 类型转扩展名
+
+## 依赖
+
+- requests
+- pytz
+- deprecated
+- oss2
+- aliyun-log-python-sdk
+- chinese_calendar
+
+## License
+
+BSD-3-Clause

enconia_utils-0.1.0/README.md

@@ -0,0 +1,52 @@
+# enconia-utils
+
+Enconia 工具包，提供常用的 Python 工具函数集合。
+
+## 安装
+
+```bash
+pip install enconia-utils
+```
+
+## 功能模块
+
+### ID 生成器 (`id_generator`)
+- `get_random_short_id()` - 生成 8 位随机短 ID
+- `get_random_long_id()` - 生成 22 位随机长 ID
+- `get_fix_short_id(base_str)` - 根据输入字符串生成固定的短 ID
+- `get_fix_long_id(base_str)` - 根据输入字符串生成固定的长 ID
+- `get_file_md5(filepath)` - 计算文件 MD5
+
+### 日期工具 (`util_date`)
+- `get_orbit_std_datetime()` - 获取标准格式的当前日期时间
+- `get_orbit_std_date()` - 获取标准格式的当前日期
+- `get_date_range_list_v2(start, end)` - 获取日期范围列表
+- `get_next_day(day, interval)` - 获取下一天
+- `get_next_workday_cn(day)` - 获取下一个中国工作日
+
+### 飞书推送 (`feishu_push`)
+- `FeiShuTalkChatBot` - 飞书机器人消息推送
+
+### 阿里云 SLS 日志 (`aliyun_sls_log`)
+- `send_log_to_sls()` - 发送日志到阿里云 SLS
+
+### 阿里云 OSS (`util_oss`)
+- `OssCloudObjectProvider` - OSS 文件操作（上传、下载、复制、删除等）
+
+### 文件类型映射 (`util_type_mapping`)
+- `get_content_type_4_filename(filename)` - 根据文件名获取 MIME 类型
+- `file2content_type(ext)` - 扩展名转 MIME 类型
+- `content2file_type(mime)` - MIME 类型转扩展名
+
+## 依赖
+
+- requests
+- pytz
+- deprecated
+- oss2
+- aliyun-log-python-sdk
+- chinese_calendar
+
+## License
+
+BSD-3-Clause

enconia_utils-0.1.0/enconia_utils/__init__.py

@@ -0,0 +1,71 @@
+"""工具函数集合"""
+
+from .aliyun_sls_log import send_log_to_sls
+from .feishu_push import FeiShuTalkChatBot, NotifyLevel
+from .id_generator import (
+    get_random_short_id,
+    get_fix_short_id,
+    get_random_long_id,
+    get_fix_long_id,
+    get_random_uuid,
+    get_fix_uuid,
+    get_file_md5,
+)
+from .util_date import (
+    DateTimeFormat,
+    DateMaxMin,
+    DateEncoder,
+    get_orbit_std_datetime,
+    get_orbit_std_datetime_utc,
+    get_orbit_std_date,
+    get_orbit_std_date_utc,
+    get_date_range_by_base,
+    get_date_range_list_v1,
+    get_date_range_list_v2,
+    get_next_day,
+    get_next_workday_cn,
+)
+from .util_oss import OssCloudObjectProvider
+from .util_type_mapping import (
+    ExtenCons,
+    content2file_type,
+    file2content_type,
+    get_content_type_4_filename,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    # aliyun_sls_log
+    "send_log_to_sls",
+    # feishu_push
+    "FeiShuTalkChatBot",
+    "NotifyLevel",
+    # id_generator
+    "get_random_short_id",
+    "get_fix_short_id",
+    "get_random_long_id",
+    "get_fix_long_id",
+    "get_random_uuid",
+    "get_fix_uuid",
+    "get_file_md5",
+    # util_date
+    "DateTimeFormat",
+    "DateMaxMin",
+    "DateEncoder",
+    "get_orbit_std_datetime",
+    "get_orbit_std_datetime_utc",
+    "get_orbit_std_date",
+    "get_orbit_std_date_utc",
+    "get_date_range_by_base",
+    "get_date_range_list_v1",
+    "get_date_range_list_v2",
+    "get_next_day",
+    "get_next_workday_cn",
+    # util_oss
+    "OssCloudObjectProvider",
+    # util_type_mapping
+    "ExtenCons",
+    "content2file_type",
+    "file2content_type",
+    "get_content_type_4_filename",
+]

enconia_utils-0.1.0/enconia_utils/aliyun_sls_log.py

@@ -0,0 +1,133 @@
+"""
+集成阿里云SLS日志服务
+
+使用说明：
+1. 安装依赖：
+   pip install aliyun-log-python-sdk
+
+2. 配置阿里云SLS：
+   - 在阿里云控制台创建Project和Logstore
+   - 获取AccessKey ID和AccessKey Secret
+   - 设置环境变量或修改下方配置：
+     ALIBABA_CLOUD_ACCESS_KEY_ID=你的AccessKeyID
+     ALIBABA_CLOUD_ACCESS_KEY_SECRET=你的AccessKeySecret
+
+3. 配置信息获取：
+   - Endpoint: 在SLS控制台查看，如 cn-hangzhou.log.aliyuncs.com
+   - Project: 在SLS控制台创建的项目名称
+   - Logstore: 在项目下创建的日志库名称
+
+4. 验证配置：
+   - 运行脚本后查看SLS控制台是否收到日志
+   - 检查本地日志文件 logs/*.log
+
+5. 查看日志：
+   - SLS控制台: https://sls.console.aliyun.com
+   - 本地日志: logs/*.log
+
+当前实现：
+- 使用阿里云官方SLS Python SDK写入日志
+- 支持SDK和HTTP API两种发送方式（自动降级）
+- 所有关键操作都会同时记录到本地日志和SLS
+"""
+import logging
+
+import requests
+import time
+import os
+from datetime import datetime
+from aliyun.log import LogClient, LogItem, PutLogsRequest
+
+# 阿里云SLS日志服务配置
+# try:
+#     from aliyun.log import LogClient, LogItem, PutLogsRequest
+#     SLS_SDK_AVAILABLE = True
+# except ImportError:
+#     SLS_SDK_AVAILABLE = False
+#     logging.warning("阿里云SLS SDK未安装，将使用HTTP API方式发送日志")
+
+
+# 阿里云SLS配置信息 - 请根据实际情况修改
+SLS_SDK_AVAILABLE = True
+SLS_ENDPOINT = 'cn-shanghai.log.aliyuncs.com'  # 您的日志服务Endpoint
+SLS_PROJECT = 'mineru-logs'  # 您的Project名称
+SLS_LOGSTORE = 'mineru-3log'  # 您的Logstore名称
+SLS_ACCESS_KEY_ID = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', 'LTAI5tLtyiy18UAWL626k1wC')
+SLS_ACCESS_KEY_SECRET = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'T6VSV1QFn7hsc8wjrOGG8K4meDyXbX')
+
+logger = logging.getLogger(__name__)
+
+def send_log_to_sls(script_name,level, message, **kwargs):
+    """发送日志到阿里云SLS"""
+    try:
+        if SLS_SDK_AVAILABLE:
+            # 使用SDK方式发送日志
+            client = LogClient(SLS_ENDPOINT, SLS_ACCESS_KEY_ID, SLS_ACCESS_KEY_SECRET)
+
+            # 创建日志项
+            log_item = LogItem()
+            log_item.set_time(int(time.time()))
+
+            # 添加日志内容
+            log_item.set_contents([
+                ('level', level),
+                ('message', message),
+                ('timestamp', datetime.now().isoformat()),
+                ('script', script_name),
+                ('extra_info', str(kwargs) if kwargs else '')
+            ])
+
+            # 构建请求
+            request = PutLogsRequest(SLS_PROJECT, SLS_LOGSTORE, '', '', [log_item])
+
+            # 发送日志
+            response = client.put_logs(request)
+
+            # put_logs在成功时不会抛出异常，如果失败会抛出异常
+            logger.info(f"SLS日志发送成功: {message}")
+
+        else:
+            # 使用HTTP API方式发送日志
+            send_log_via_http(script_name,level, message, **kwargs)
+
+    except Exception as e:
+        logger.error(f"SLS日志发送异常: {str(e)}")
+        # 如果SDK方式失败，尝试使用HTTP方式
+        try:
+            send_log_via_http(script_name,level, message, **kwargs)
+        except Exception as http_e:
+            logger.error(f"HTTP方式也发送失败: {str(http_e)}")
+
+
+def send_log_via_http(script_name, level, message, **kwargs):
+    """通过HTTP API发送日志到SLS"""
+    try:
+
+        # 构建日志数据
+        log_data = {
+            'level': level,
+            'message': message,
+            'timestamp': datetime.now().isoformat(),
+            'script': script_name,
+            'extra_info': kwargs if kwargs else {}
+        }
+
+        # 构建请求头
+        headers = {
+            'Content-Type': 'application/json',
+            'x-log-apiversion': '0.6.0',
+            'x-log-signaturemethod': 'hmac-sha1'
+        }
+
+        # 发送HTTP请求到SLS API
+        url = f"https://{SLS_ENDPOINT}/logstores/{SLS_LOGSTORE}/shards/lb"
+
+        response = requests.post(url, headers=headers, json=log_data, timeout=5)
+
+        if response.status_code == 200:
+            logger.info(f"HTTP方式SLS日志发送成功: {message}")
+        else:
+            logger.error(f"HTTP方式SLS日志发送失败: 状态码={response.status_code}, 响应={response.text[:200]}")
+
+    except Exception as e:
+        logger.error(f"HTTP方式SLS日志发送异常: {str(e)}")

enconia_utils-0.1.0/enconia_utils/feishu_push.py

@@ -0,0 +1,173 @@
+import requests
+import json
+import time
+import logging
+from enum import Enum
+from typing import Optional, List, Dict
+
+try:
+    JSONDecodeError = json.decoder.JSONDecodeError
+except AttributeError:
+    JSONDecodeError = ValueError
+
+
+class NotifyLevel(Enum):
+    SUCCESS = 'green'
+    INFO = 'wathet'
+    WARNING = 'yellow'
+    DANGER = 'red'
+
+
+class FeiShuTalkChatBot:
+    def __init__(self, webhook, secret=None, pc_slide=False, fail_notice=False):
+        '''
+        机器人初始化
+        Reference doc: https://open.feishu.cn/document/client-docs/bot-v3/add-custom-bot
+
+        :param webhook: 飞书群自定义机器人webhook地址
+        :param secret: 机器人安全设置页面勾选“加签”时需要传入的密钥
+        :param pc_slide: 消息链接打开方式，默认False为浏览器打开，设置为True时为PC端侧边栏打开
+        :param fail_notice: 消息发送失败提醒，默认为False不提醒，开发者可以根据返回的消息发送结果自行判断和处理
+        '''
+        super(FeiShuTalkChatBot, self).__init__()
+        self.headers = {'Content-Type': 'application/json; charset=utf-8'}
+        self.webhook = webhook
+        self.secret = secret
+        self.pc_slide = pc_slide
+        self.fail_notice = fail_notice
+
+    def success(self, message, title: str = 'Successfully', ats: Optional[List] = None, action=None):
+        self.send_text(title=title, message=message, level=NotifyLevel.SUCCESS.value, ats=ats, action=action)
+
+    def info(self, message, title: str = 'Notification', ats: Optional[List] = None, action=None):
+        self.send_text(title=title, message=message, level=NotifyLevel.INFO.value, ats=ats, action=action)
+
+    def warning(self, message, title: str = 'Warning', ats: Optional[List] = None, action=None):
+        self.send_text(title=title, message=message, level=NotifyLevel.WARNING.value, ats=ats, action=action)
+
+    def error(self, message, title: str = 'Error', ats: Optional[List] = None, action=None):
+        self.send_text(title=title, message=message, level=NotifyLevel.DANGER.value, ats=ats, action=action)
+
+    def send_text(self, title, message, level, ats: Optional[List] = None, action: Optional[Dict] = None):
+        """
+        :param title:
+        :param message:
+        :param level:
+        :param ats:
+        :param action: { "direction": "DOWN", actions: {} }
+        :return:
+        """
+        data = {
+            "msg_type": "interactive",
+            "card": {
+                "elements": [
+                    {
+                        "tag": "hr"
+                    },
+                    {
+                        "tag": "div",
+                        "text": {
+                            "tag": "lark_md",
+                            "content": message
+                        }
+                    }
+                ],
+                "header": {
+                    "title": {
+                        "content": title,
+                        "tag": "plain_text"
+                    },
+                    "template": level
+                }
+            }
+        }
+
+        # Put @ people
+        if ats:
+            if len(ats) == 1 and ats[0] == "all":
+                data["card"]["elements"].append({
+                    "tag": "div",
+                    "text": {
+                        "tag": "lark_md",
+                        "content": "At <at id=all></at>",
+                    }
+                })
+            elif len(ats) > 0:
+                at_list_template = []
+                for at in ats:
+                    at_list_template.append({
+                        "tag": "div",
+                        "text": {
+                            "tag": "lark_md",
+                            "content": "At <at id=" + at + "></at>",
+                        }
+                    })
+                data["card"]["elements"].extend(at_list_template)
+            else:
+                raise Exception("Invalid ats.")
+
+        if action:
+            if action["direction"] == "UP":
+                direction = "UP"
+            else:
+                direction = "DOWN"
+
+            if direction == "DOWN":
+                data["card"]["elements"].append({"tag": "hr"})
+                data["card"]["elements"].append(action["actions"])
+            if direction == "UP":
+                data["card"]["elements"].insert(0, action["actions"])
+
+        return self.post(data)
+
+    def post(self, data):
+        """
+        发送消息（内容UTF-8编码）
+        :param data: 消息数据（字典）
+        :return: 返回消息发送结果
+        """
+        try:
+            post_data = json.dumps(data)
+            response = requests.post(self.webhook, headers=self.headers, data=post_data, verify=False)
+
+        except requests.exceptions.HTTPError as exc:
+            logging.error("消息发送失败， HTTP error: %d, reason: %s" % (exc.response.status_code, exc.response.reason))
+            raise
+        except requests.exceptions.ConnectionError:
+            logging.error("消息发送失败，HTTP connection error!")
+            raise
+        except requests.exceptions.Timeout:
+            logging.error("消息发送失败，Timeout error!")
+            raise
+        except requests.exceptions.RequestException:
+            logging.error("消息发送失败, Request Exception!")
+            raise
+        else:
+            try:
+                result = response.json()
+            except JSONDecodeError:
+                logging.error("服务器响应异常，状态码：%s，响应内容：%s" % (response.status_code, response.text))
+                return {'errcode': 500, 'errmsg': '服务器响应异常'}
+            else:
+                logging.debug('发送结果：%s' % result)
+                # 消息发送失败提醒（errcode 不为 0，表示消息发送异常），默认不提醒，开发者可以根据返回的消息发送结果自行判断和处理
+                if self.fail_notice and result.get('errcode', True):
+                    time_now = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime(time.time()))
+                    error_data = {
+                        "msgtype": "text",
+                        "text": {
+                            "content": "[注意-自动通知]飞书机器人消息发送失败，时间：%s，原因：%s，请及时跟进，谢谢!" % (
+                                time_now, result['errmsg'] if result.get('errmsg', False) else '未知异常')
+                        },
+                        "at": {
+                            "isAtAll": False
+                        }
+                    }
+                    logging.error("消息发送失败，自动通知：%s" % error_data)
+                    requests.post(self.webhook, headers=self.headers, data=json.dumps(error_data))
+                return result
+
+
+if __name__ == '__main__':
+    lark_client = FeiShuTalkChatBot(webhook='https://open.feishu.cn/open-apis/bot/v2/hook/bba5b285-ca56-488c-9142-d8bcbcaee3c1')
+    #lark_client.success(message='testtesttesttesttesttest', title='测试标题')

enconia_utils-0.1.0/enconia_utils/id_generator.py

@@ -0,0 +1,114 @@
+import hashlib
+import uuid
+from typing import Optional
+
+"""
+版本1 vs 版本2
+
+特性	    版本1（8位62进制）	    版本2（22位62进制）
+组合数	~2.18e14（218万亿）	~3.2e35（远超UUID空间）
+碰撞阈值	14.77百万（50%概率）	5.2e19（理论极高）
+适用场景	小规模、临时ID	    大规模、高唯一性需求
+性能开销	低	                中等（大整数转换）
+扩展性	不可扩展	            支持更高并发
+
+版本2显著优于版本1：通过扩展ID长度至22位，将碰撞概率降至理论安全极限，适合金融、分布式系统等关键场景。
+推荐实践：结合数据库唯一索引或Redis缓存，实时检测并重试碰撞ID，确保万无一失
+"""
+
+printable_char = [
+    "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
+    "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w",
+    "x", "y", "z",
+    "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W",
+    "X", "Y", "Z",
+]
+
+"""版本2，生成最多 22 位的 ID
+参考链接：# https://github.com/skorokithakis/shortuuid/tree/master
+生成思路：根据 UUID3 或者 UUID4 得到的 32 位 16 进制数，转换成 62 进制的数
+"""
+
+
+def get_random_long_id(padding: Optional[int] = 22):
+    _tmp_id = get_random_uuid(with_dash=True)
+    return _convert_10_2_62(_tmp_id, padding)
+
+
+def get_fix_long_id(base_str: str, padding: Optional[int] = 22):
+    _tmp_id = get_fix_uuid(long_id=base_str, with_dash=True)
+    return _convert_10_2_62(_tmp_id, padding)
+
+
+def _convert_10_2_62(id_16: str, padding: Optional[int]):
+    _tmp_id_10 = int(id_16, 16)
+
+    output = ""
+    while _tmp_id_10:
+        _tmp_id_10, digit = divmod(_tmp_id_10, 62)
+        output += printable_char[digit]
+    if padding:
+        remainder = max(padding - len(output), 0)
+        output += printable_char[0] * remainder
+
+    return output[::-1]
+
+
+"""版本1，生成 8 位数的短 ID
+参考链接：https://www.cnblogs.com/shouke/archive/2020/08/02/13423073.html
+生成思路：根据 UUID3 或者 UUID4 得到的 32 位 16 进制数进行分组，每组 4 个，一共 8 组。对每一组的数字对 62 取余。
+"""
+
+
+def get_random_short_id():
+    _tmp_id = get_random_uuid(with_dash=True)
+    _buffer = []
+    # 循环 8 次，每次取出 4 个
+    for i in range(0, 8):
+        start = i * 4
+        end = i * 4 + 4
+        # 将 16 进制的 uuid 转换成 10 进制的数字
+        val = int(_tmp_id[start:end], 16)
+        _buffer.append(printable_char[val % 62])
+    return "".join(_buffer)
+
+
+def get_fix_short_id(long_id):
+    _tmp_id = get_fix_uuid(long_id=long_id, with_dash=True)
+    _buffer = []
+    for i in range(0, 8):
+        start = i * 4
+        end = i * 4 + 4
+        val = int(_tmp_id[start:end], 16)
+        _buffer.append(printable_char[val % 62])
+    short_id = "".join(_buffer)
+    return short_id
+
+
+"""使用 UUID3 和 UUID4 分别得到固定的和随机的 UUID
+Python 的 UUID3 生成的 ID 是 128 位的十进制数，可以表示为 32 位的十六进制数位。
+Python 的 UUID3 生成的 ID 在给定相同的命名空间和名称的情况下是唯一的，它是通过将命名空间和名称作为输入，应用 MD5 哈希算法生成的。
+由于 MD5 算法的特性，即使输入的命名空间和名称有微小的变化，生成的 ID 也会有很大的差异，从而保证了唯一性。
+"""
+
+
+def get_random_uuid(with_dash=False):
+    if with_dash:
+        return str(uuid.uuid4()).replace("-", '')
+    else:
+        return str(uuid.uuid4())
+
+
+def get_fix_uuid(long_id, with_dash=False):
+    if with_dash:
+        return str(uuid.uuid3(uuid.NAMESPACE_DNS, long_id)).replace("-", '')
+    else:
+        return str(uuid.uuid3(uuid.NAMESPACE_DNS, long_id))
+
+
+def get_file_md5(filepath):
+    with open(filepath, 'rb+') as f:
+        md5obj = hashlib.md5()
+        md5obj.update(f.read())
+        hash_ = md5obj.hexdigest()
+        return str(hash_).upper()