enconia-utils 0.1.0__py3-none-any.whl

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/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/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/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()

enconia_utils/util_date.py

@@ -0,0 +1,187 @@
+import datetime
+import json
+from enum import Enum
+from typing import List, Optional
+import pytz
+from deprecated.sphinx import deprecated
+
+
+class DateTimeFormat(Enum):
+    '''Orbit date format
+    '''
+
+    DATETIME_FORMAT = "%Y-%m-%dT%H:%M:%S%z"
+    DATE_FORMAT = "%Y-%m-%d"
+
+
+class DateMaxMin(Enum):
+    '''Orbit date time min & max range
+    '''
+
+    DATE_MIN = "1000-01-01"
+    DATE_MAX = "2100-12-31"
+
+    DATETIME_MIN_UTC = "1000-01-01T00:00:00+0000"
+    DATETIME_MAX_UTC = "2100-12-31T29:59:59+0000"
+
+
+class DateEncoder(json.JSONEncoder):
+    def default(self, obj):
+        if isinstance(obj, datetime.datetime):
+            return obj.strftime(DateTimeFormat.DATETIME_FORMAT.value)
+        elif isinstance(obj, datetime.date):
+            return obj.strftime(DateTimeFormat.DATE_FORMAT.value)
+        else:
+            return json.JSONEncoder.default(self, obj)
+
+
+# -------------------------------------------------------------------------------------------------------------
+# Below 2 methods are for getting Orbit standard datetime.
+# -------------------------------------------------------------------------------------------------------------
+@deprecated(version="v1", reason="Use get_orbit_std_datetime instead.")
+def get_orbit_std_datatime():
+    current_timezone = datetime.datetime.now(datetime.timezone.utc).astimezone().tzinfo
+    return datetime.datetime.now(tz=current_timezone).strftime(DateTimeFormat.DATETIME_FORMAT.value)
+
+
+@deprecated(version="v1", reason="Use get_orbit_std_datetime_utc instead.")
+def get_orbit_std_datatime_utc():
+    return datetime.datetime.now(tz=pytz.timezone('UTC')).strftime(DateTimeFormat.DATETIME_FORMAT.value)
+
+
+def get_orbit_std_datetime():
+    current_timezone = datetime.datetime.now(datetime.timezone.utc).astimezone().tzinfo
+    return datetime.datetime.now(tz=current_timezone).strftime(DateTimeFormat.DATETIME_FORMAT.value)
+
+
+def get_orbit_std_datetime_utc():
+    return datetime.datetime.now(tz=pytz.timezone('UTC')).strftime(DateTimeFormat.DATETIME_FORMAT.value)
+
+
+# -------------------------------------------------------------------------------------------------------------
+# Below 2 methods are for getting Orbit standard date.
+# -------------------------------------------------------------------------------------------------------------
+def get_orbit_std_date():
+    return datetime.datetime.now(
+        tz=datetime.datetime.now(datetime.timezone.utc).astimezone().tzinfo
+    ).strftime(DateTimeFormat.DATE_FORMAT.value)
+
+
+def get_orbit_std_date_utc():
+    return datetime.datetime.now(tz=pytz.timezone('UTC')).strftime(DateTimeFormat.DATE_FORMAT.value)
+
+
+def get_date_range_by_base(date_range: int,
+                           base_date: Optional[datetime.datetime] = None,
+                           direction: str = "backward",
+                           formatter: str = "%Y-%m-%d") -> List:
+    """
+    Get date range by datetime.
+    :param date_range:
+    :param base_date:
+    :param direction:
+    :param formatter:
+    :return: A list of date range.
+    """
+    if date_range <= 0:
+        raise Exception("Param err")
+
+    if base_date is None:
+        base_date = datetime.datetime.now()
+
+    timedelta = datetime.timedelta(days=date_range - 1)
+    if direction == "backward":
+        start_date = base_date - timedelta
+        end_date = base_date
+    elif direction == "forward":
+        start_date = base_date
+        end_date = base_date + timedelta
+    else:
+        raise Exception("Param err")
+
+    return get_date_range_list_v2(start_date.strftime("%Y-%m-%d"), end_date.strftime("%Y-%m-%d"), post_formatter=formatter)
+
+
+def get_date_range_list_v1(start_date, end_date) -> List:
+    """
+    This method will return a list in which all date range are included with the very start and ending.
+    :param start_date: '2019-06-03'
+    :param end_date: '2019-06-05'
+    :return:
+    """
+    datestart = datetime.datetime.strptime(start_date, "%Y-%m-%d")
+    dateend = datetime.datetime.strptime(end_date, "%Y-%m-%d")
+    dateend += datetime.timedelta(days=1)
+
+    day_list_with_range = []
+    while datestart < dateend:
+        day_list_with_range.append(datestart.strftime("%Y-%m-%d"))
+        datestart += datetime.timedelta(days=1)
+
+    return day_list_with_range
+
+
+def get_date_range_list_v2(start_date, end_date, pre_formatter="%Y-%m-%d", post_formatter="%Y-%m-%d") -> List:
+    """
+    This method will return a list in which all date range are included with the very start and ending.
+    :param post_formatter: Default is %Y-%m-%d
+    :param pre_formatter: Default is %Y-%m-%d
+    :param start_date: '2019-06-03'
+    :param end_date: '2019-06-05'
+    :return:
+    """
+    datestart = datetime.datetime.strptime(start_date, pre_formatter)
+    dateend = datetime.datetime.strptime(end_date, pre_formatter)
+    dateend += datetime.timedelta(days=1)
+
+    day_list_with_range = []
+    while datestart < dateend:
+        day_list_with_range.append(datestart.strftime(post_formatter))
+        datestart += datetime.timedelta(days=1)
+
+    return day_list_with_range
+
+
+def get_next_day(day: str, interval: int = 1, date_format="%Y-%m-%d") -> str:
+    """
+    Get the next day by given date
+    :param day:
+    :param interval:
+    :param date_format:
+    :return:
+    """
+
+    target_day = datetime.datetime.strptime(day, date_format)
+    next_day = target_day + datetime.timedelta(days=interval)
+    return next_day.strftime(date_format)
+
+
+def get_next_workday_cn(workday: str, interval: int = 1, date_format: str = "%Y-%m-%d") -> str:
+    """
+    Get the next trading date by Chinese calendar
+    :param workday:
+    :param interval:
+    :param date_format:
+    :return:
+    """
+
+    try:
+        from chinese_calendar import is_workday
+    except ImportError:
+        raise ValueError(
+            "Please install below packages before using this function.\n"
+            "- chinese_calendar"
+        )
+
+    # Start to judge
+    next_date = datetime.datetime.strptime(
+        get_next_day(day=workday, interval=interval, date_format=date_format),
+        date_format
+    )
+    while not is_workday(next_date) or next_date.weekday() in (5, 6):
+        next_date = datetime.datetime.strptime(
+            get_next_day(day=next_date.strftime(date_format), interval=interval, date_format=date_format),
+            date_format
+        )
+
+    return next_date.strftime(date_format)

enconia_utils/util_oss.py

@@ -0,0 +1,98 @@
+import os
+import re
+
+import oss2
+from oss2.credentials import EnvironmentVariableCredentialsProvider
+from .util_type_mapping import get_content_type_4_filename
+
+
+os.environ['OSS_ACCESS_KEY_ID'] = 'LTAI5tLtyiy18UAWL626k1wC'
+os.environ['OSS_ACCESS_KEY_SECRET'] = 'T6VSV1QFn7hsc8wjrOGG8K4meDyXbX'
+
+
+class OssCloudObjectProvider:
+
+    def __init__(self):
+        self.oss_endpoint = 'https://oss-cn-shanghai.aliyuncs.com'
+        self.region = 'cn-shanghai'
+        self.auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
+
+    def oss_split_path(self, oss_path):
+        if not oss_path.startswith('oss://'):
+            raise Exception(f"Invalid oss path format: {oss_path}")
+        oss_path_re = re.compile(r"(oss://[a-zA-Z\-_0-9]+)/(.+)")
+        path_group = oss_path_re.search(oss_path).groups()
+        bucket = path_group[0].replace('oss://', '')
+        if not bucket:
+            raise Exception(f"Invalid oss path format: {oss_path}")
+        key = path_group[1]
+        if not key:
+            raise Exception(f"Invalid oss path format: {oss_path}")
+        return bucket, key
+
+    def copy_oss_obj(self, src_oss_path: str, dst_oss_path: str):
+        src_bucket, src_key = self.oss_split_path(src_oss_path)
+        dst_bucket, dst_key = self.oss_split_path(dst_oss_path)
+        bucket_obj = oss2.Bucket(self.auth, self.oss_endpoint, dst_bucket, region=self.region)
+        result = bucket_obj.copy_object(src_bucket, src_key, dst_key)
+        if result.status != 200:
+            raise Exception(f"Copy failed with status code {result.status}")
+
+    def check_file_exist(self, oss_path: str) -> bool:
+        bucket, key = self.oss_split_path(oss_path)
+        bucket_obj = oss2.Bucket(self.auth, self.oss_endpoint, bucket, region=self.region)
+        oss_result = bucket_obj.object_exists(key)
+        return oss_result
+
+    def upload_file(self, oss_path: str, local_path: str):
+        if not os.path.exists(local_path):
+            raise Exception("Local file doesn't exist!")
+        bucket, key = self.oss_split_path(oss_path)
+        bucket_obj = oss2.Bucket(self.auth, self.oss_endpoint, bucket, region=self.region)
+        content_type = get_content_type_4_filename(local_path, text_with_utf8=True)
+        result = bucket_obj.put_object_from_file(key, local_path, headers={"Content-Type": content_type})
+        if result.status != 200:
+            raise Exception(f"Upload failed with status code {result.status}")
+
+    def download_file(self, oss_path: str, local_path: str, filename: str):
+        if not os.path.exists(local_path):
+            os.makedirs(local_path)
+        bucket, key = self.oss_split_path(oss_path)
+        bucket_obj = oss2.Bucket(self.auth, self.oss_endpoint, bucket, region=self.region)
+        bucket_obj.get_object_to_file(key, os.path.join(local_path, filename))
+
+    def get_presign_url_docs(self, oss_path: str, expire_hours: int = 1) -> str:
+        bucket, key = self.oss_split_path(oss_path)
+        bucket_obj = oss2.Bucket(self.auth, 'http://docs.huanai.tech', bucket, region=self.region, is_cname=True)
+        expire_seconds = expire_hours * 60 * 60
+        return bucket_obj.sign_url('GET', key, expire_seconds, slash_safe=True)
+
+    def get_upload_url(self, oss_path: str, expire_hours: int = 1) -> str:
+        bucket, key = self.oss_split_path(oss_path)
+        bucket_obj = oss2.Bucket(self.auth, self.oss_endpoint, bucket, region=self.region)
+        expire_seconds = expire_hours * 60 * 60
+        return bucket_obj.sign_url('PUT', key, expire_seconds, slash_safe=True)
+
+    def list_dir_iter(self, oss_path_pre: str):
+        bucket, key_pre = self.oss_split_path(oss_path_pre)
+        bucket = oss2.Bucket(self.auth, self.oss_endpoint, bucket, region=self.region)
+        for obj in oss2.ObjectIterator(bucket, prefix=key_pre):
+            yield obj.key
+
+    def get_file_content(self, oss_path: str):
+        bucket, key = self.oss_split_path(oss_path)
+        bucket_obj = oss2.Bucket(self.auth, self.oss_endpoint, bucket, region=self.region)
+        return bucket_obj.get_object(key).read()
+
+    def delete_file_from_oss(self, oss_path: str):
+        bucket, key = self.oss_split_path(oss_path)
+        bucket_obj = oss2.Bucket(self.auth, self.oss_endpoint, bucket, region=self.region)
+        result = bucket_obj.delete_object(key)
+        if result.status != 204:
+            raise Exception(f"Delete failed with status code {result.status}")
+
+# if __name__ == '__main__':
+#     oss_client = OssCloudObjectProvider(OSSAPPID, OSSPWD, OSSENDPOINT)
+#     # oss_client.upload_file('oss://dev-test-ha/tabel1.pdf', 'table1.pdf')
+#     url = oss_client.get_presign_url(f'oss://dev-test-ha/tabel1.pdf')
+#     print(url)

enconia_utils/util_type_mapping.py

@@ -0,0 +1,343 @@
+import threading
+from enum import Enum
+
+'''
+Reference link: https://www.lifewire.com/file-extensions-and-mime-types-3469109
+Reference link: https://superuser.com/questions/62852/xlsx-files-are-being-interpreted-as-zip-files-on-download-why
+# Applications
+doc / docx / ppt / pptx / xls / xlsx / pdf / json / js
+# Text Files
+html / htm / txt
+'''
+
+
+class ExtenCons(Enum):
+    '''
+    Useful constant variables
+    '''
+
+    EXTEN_OCTET_STREAM = 'application/octet-stream'
+    # Application
+    EXTEN_APPLI_PDF = 'application/pdf'
+    EXTEN_APPLI_XML = 'application/xml'
+    EXTEN_APPLI_JSON = 'application/json'
+    EXTEN_APPLI_JS = 'application/x-javascript'
+    EXTEN_APPLI_DOC = 'application/msword'
+    EXTEN_APPLI_DOCX = 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+    EXTEN_APPLI_XLS = 'application/vnd.ms-excel'
+    EXTEN_APPLI_XLSX = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+    EXTEN_APPLI_PPT = 'application/vnd.ms-powerpoint'
+    EXTEN_APPLI_PPTX = 'application/vnd.openxmlformats-officedocument.presentationml.presentation'
+    # Text Files
+    EXTEN_TEXT_HTML = 'text/html'
+    EXTEN_TEXT_HTM = 'text/html'
+    EXTEN_TEXT_TXT = 'text/plain'
+    # Text Files with charset
+    EXTEN_TEXT_HTML_UTF8 = 'text/html;charset=utf-8'
+    EXTEN_TEXT_HTM_UTF8 = 'text/html;charset=utf-8'
+    EXTEN_TEXT_TXT_UTF8 = 'text/plain;charset=utf-8'
+
+
+_content_file_mapping = {
+    # MIME Types: Applications
+    '*': {'application': 'Binary file', 'mine': 'application/octet-stream'},
+    'pdf': {'application': 'pdf document', 'mine': 'application/pdf'},
+    'json': {'application': 'json document', 'mine': 'application/json'},
+    'evy': {'application': 'Corel Envoy', 'mine': 'application/envoy'},
+    'xml': {'application': 'XML document', 'mine': 'application/xml'},
+    # Word related
+    'dot': {'application': 'Word document template', 'mine': 'application/msword'},
+    'doc': {'application': 'Word document', 'mine': 'application/msword'},
+    'docx': {'application': 'docx document', 'mine': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'},
+    'docm': {'application': '', 'mine': 'application/vnd.ms-word.document.macroEnabled.12'},  # Added in 07 Mar, 2024
+    'dotx': {'application': '', 'mine': 'application/vnd.openxmlformats-officedocument.wordprocessingml.template'},  # Added in 07 Mar, 2024
+    'fif': {'application': 'fractal image file', 'mine': 'application/fractals'},
+    'spl': {'application': 'Windows print spool file', 'mine': 'application/futuresplash'},
+    'hta': {'application': 'HTML application', 'mine': 'application/hta'},
+    'acx': {'application': 'Atari ST Program', 'mine': 'application/internet-property-stream'},
+    'hqx': {'application': 'BinHex encoded file', 'mine': 'application/mac-binhex40'},
+    'bin': {'application': 'binary disk image', 'mine': 'application/octet-stream'},
+    'class': {'application': 'Java class file', 'mine': 'application/octet-stream'},
+    'dms': {'application': 'Disk Masher image', 'mine': 'application/octet-stream'},
+    'exe': {'application': 'executable file', 'mine': 'application/octet-stream'},
+    'lha': {'application': 'LHARC compressed archive', 'mine': 'application/octet-stream'},
+    'lzh': {'application': 'LZH compressed file', 'mine': 'application/octet-stream'},
+    'oda': {'application': 'CALS raster image', 'mine': 'application/oda'},
+    'axs': {'application': 'ActiveX script', 'mine': 'application/olescript'},
+    'prf': {'application': 'Outlook profile file', 'mine': 'application/pics-rules'},
+    'p10': {'application': 'certificate request file', 'mine': 'application/pkcs10'},
+    'crl': {'application': 'certificate revocation list file', 'mine': 'application/pkix-crl'},
+    'ai': {'application': 'Adobe Illustrator file', 'mine': 'application/postscript'},
+    'eps': {'application': 'postscript file', 'mine': 'application/postscript'},
+    'ps': {'application': 'postscript file', 'mine': 'application/postscript'},
+    'rtf': {'application': 'rich text format file', 'mine': 'application/rtf'},
+    'setpay': {'application': 'set payment initiation', 'mine': 'application/set-payment-initiation'},
+    'setreg': {'application': 'set registration initiation', 'mine': 'application/set-registration-initiation'},
+    # Excel related
+    'xla': {'application': 'Excel Add-in file', 'mine': 'application/vnd.ms-excel'},
+    'xlc': {'application': 'Excel chart', 'mine': 'application/vnd.ms-excel'},
+    'xlm': {'application': 'Excel macro', 'mine': 'application/vnd.ms-excel'},
+    'xls': {'application': 'Excel spreadsheet', 'mine': 'application/vnd.ms-excel'},
+    'xlsx': {'application': 'xlsx document', 'mine': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'},
+    'xlt': {'application': 'Excel template', 'mine': 'application/vnd.ms-excel'},
+    'xlw': {'application': 'Excel worspace', 'mine': 'application/vnd.ms-excel'},
+    'xlam': {'application': '', 'mine': 'application/vnd.ms-excel.addin.macroEnabled.12'},  # Added in 07 Mar, 2024
+    'xlsb': {'application': '', 'mine': 'application/vnd.ms-excel.sheet.binary.macroEnabled.12'},  # Added in 07 Mar, 2024
+    'xlsm': {'application': '', 'mine': 'application/vnd.ms-excel.sheet.macroEnabled.12'},  # Added in 07 Mar, 2024
+    'xltm': {'application': '', 'mine': 'application/vnd.ms-excel.template.macroEnabled.12'},  # Added in 07 Mar, 2024
+    'xltx': {'application': '', 'mine': 'application/vnd.openxmlformats-officedocument.spreadsheetml.template'},  # Added in 07 Mar, 2024
+    'msg': {'application': 'Outlook mail message', 'mine': 'application/vnd.ms-outlook'},
+    'sst': {'application': 'serialized certificate store file', 'mine': 'application/vnd.ms-pkicertstore'},
+    'cat': {'application': 'Windows catalog file', 'mine': 'application/vnd.ms-pkiseccat'},
+    'stl': {'application': 'stereolithography file', 'mine': 'application/vnd.ms-pkistl'},
+    # ppt related
+    'pot': {'application': 'PowerPoint template', 'mine': 'application/vnd.ms-powerpoint'},
+    'pps': {'application': 'PowerPoint slide show', 'mine': 'application/vnd.ms-powerpoint'},
+    'ppt': {'application': 'PowerPoint presentation', 'mine': 'application/vnd.ms-powerpoint'},
+    'pptx': {'application': 'pptx document', 'mine': 'application/vnd.openxmlformats-officedocument.presentationml.presentation'},
+    'potm': {'application': '', 'mine': 'application/vnd.ms-powerpoint.template.macroEnabled.12'},  # Added in 07 Mar, 2024
+    'potx': {'application': '', 'mine': 'application/vnd.openxmlformats-officedocument.presentationml.template'},  # Added in 07 Mar, 2024
+    'ppam': {'application': '', 'mine': 'application/vnd.ms-powerpoint.addin.macroEnabled.12'},  # Added in 07 Mar, 2024
+    'ppsm': {'application': '', 'mine': 'application/vnd.ms-powerpoint.slideshow.macroEnabled.12'},  # Added in 07 Mar, 2024
+    'ppsx': {'application': '', 'mine': 'application/vnd.openxmlformats-officedocument.presentationml.slideshow'},  # Added in 07 Mar, 2024
+    'pptm': {'application': '', 'mine': 'application/vnd.ms-powerpoint.presentation.macroEnabled.12'},  # Added in 07 Mar, 2024
+    'mpp': {'application': 'Microsoft Project file', 'mine': 'application/vnd.ms-project'},
+    'wcm': {'application': 'WordPerfect macro', 'mine': 'application/vnd.ms-works'},
+    'wdb': {'application': 'Microsoft Works database', 'mine': 'application/vnd.ms-works'},
+    'wks': {'application': 'Microsoft Works spreadsheet', 'mine': 'application/vnd.ms-works'},
+    'wps': {'application': 'Microsoft Works word processsor document', 'mine': 'application/vnd.ms-works'},
+    'hlp': {'application': 'Windows help file', 'mine': 'application/winhlp'},
+    'bcpio': {'application': 'binary CPIO archive', 'mine': 'application/x-bcpio'},
+    'cdf': {'application': 'computable document format file', 'mine': 'application/x-cdf'},
+    'z': {'application': 'Unix compressed file', 'mine': 'application/x-compress'},
+    'tgz': {'application': 'gzipped tar file', 'mine': 'application/x-compressed'},
+    'cpio': {'application': 'Unix CPIO archive', 'mine': 'application/x-cpio'},
+    'csh': {'application': 'Photoshop custom shapes file', 'mine': 'application/x-csh'},
+    'dcr': {'application': 'Kodak RAW image file', 'mine': 'application/x-director'},
+    'dir': {'application': 'Adobe Director movie', 'mine': 'application/x-director'},
+    'dxr': {'application': 'Macromedia Director movie', 'mine': 'application/x-director'},
+    'dvi': {'application': 'device independent format file', 'mine': 'application/x-dvi'},
+    'gtar': {'application': 'Gnu tar archive', 'mine': 'application/x-gtar'},
+    'gz': {'application': 'Gnu zipped archive', 'mine': 'application/x-gzip'},
+    'hdf': {'application': 'hierarchical data format file', 'mine': 'application/x-hdf'},
+    'ins': {'application': 'internet settings file', 'mine': 'application/x-internet-signup'},
+    'isp': {'application': 'IIS internet service provider settings', 'mine': 'application/x-internet-signup'},
+    'iii': {'application': 'ARC+ architectural file', 'mine': 'application/x-iphone'},
+    'js': {'application': 'JavaScript file', 'mine': 'application/x-javascript'},
+    'latex': {'application': 'LaTex document', 'mine': 'application/x-latex'},
+    'mdb': {'application': 'Microsoft Access database', 'mine': 'application/x-msaccess'},
+    'crd': {'application': 'Windows CardSpace file', 'mine': 'application/x-mscardfile'},
+    'clp': {'application': 'CrazyTalk clip file', 'mine': 'application/x-msclip'},
+    'dll': {'application': 'dynamic link library', 'mine': 'application/x-msdownload'},
+    'm13': {'application': 'Microsoft media viewer file', 'mine': 'application/x-msmediaview'},
+    'm14': {'application': 'Steuer2001 file', 'mine': 'application/x-msmediaview'},
+    'mvb': {'application': 'multimedia viewer book source file', 'mine': 'application/x-msmediaview'},
+    'wmf': {'application': 'Windows meta file', 'mine': 'application/x-msmetafile'},
+    'mny': {'application': 'Microsoft Money file', 'mine': 'application/x-msmoney'},
+    'pub': {'application': 'Microsoft Publisher file', 'mine': 'application/x-mspublisher'},
+    'scd': {'application': 'Turbo Tax tax schedule list', 'mine': 'application/x-msschedule'},
+    'trm': {'application': 'FTR media file', 'mine': 'application/x-msterminal'},
+    'wri': {'application': 'Microsoft Write file', 'mine': 'application/x-mswrite'},
+    'nc': {'application': 'Mastercam numerical control file', 'mine': 'application/x-netcdf'},
+    'pma': {'application': 'MSX computers archive format', 'mine': 'application/x-perfmon'},
+    'pmc': {'application': 'performance monitor counter file', 'mine': 'application/x-perfmon'},
+    'pml': {'application': 'process monitor log file', 'mine': 'application/x-perfmon'},
+    'pmr': {'application': 'Avid persistant media record file', 'mine': 'application/x-perfmon'},
+    'pmw': {'application': 'Pegasus Mail draft stored message', 'mine': 'application/x-perfmon'},
+    'p12': {'application': 'personal information exchange file', 'mine': 'application/x-pkcs12'},
+    'pfx': {'application': 'PKCS #12 certificate file', 'mine': 'application/x-pkcs12'},
+    'p7b': {'application': 'PKCS #7 certificate file', 'mine': 'application/x-pkcs7-certificates'},
+    'spc': {'application': 'software publisher certificate file', 'mine': 'application/x-pkcs7-certificates'},
+    'p7r': {'application': 'certificate request response file', 'mine': 'application/x-pkcs7-certreqresp'},
+    'p7c': {'application': 'PKCS #7 certificate file', 'mine': 'application/x-pkcs7-mime'},
+    'p7m': {'application': 'digitally encrypted message', 'mine': 'application/x-pkcs7-mime'},
+    'p7s': {'application': 'digitally signed email message', 'mine': 'application/x-pkcs7-signature'},
+    'sh': {'application': 'Bash shell script', 'mine': 'application/x-sh'},
+    'shar': {'application': 'Unix shar archive', 'mine': 'application/x-shar'},
+    'swf': {'application': 'Flash file', 'mine': 'application/x-shockwave-flash'},
+    'sit': {'application': 'Stuffit archive file', 'mine': 'application/x-stuffit'},
+    'sv4cpio': {'application': 'system 5 release 4 CPIO file', 'mine': 'application/x-sv4cpio'},
+    'sv4crc': {'application': 'system 5 release 4 CPIO checksum data', 'mine': 'application/x-sv4crc'},
+    'tar': {'application': 'consolidated Unix file archive', 'mine': 'application/x-tar'},
+    'tcl': {'application': 'Tcl script', 'mine': 'application/x-tcl'},
+    'tex': {'application': 'LaTeX source document', 'mine': 'application/x-tex'},
+    'texi': {'application': 'LaTeX info document', 'mine': 'application/x-texinfo'},
+    'texinfo': {'application': 'LaTeX info document', 'mine': 'application/x-texinfo'},
+    'roff': {'application': 'unformatted manual page', 'mine': 'application/x-troff'},
+    't': {'application': 'Turing source code file', 'mine': 'application/x-troff'},
+    'tr': {'application': 'TomeRaider 2 ebook file', 'mine': 'application/x-troff'},
+    'man': {'application': 'Unix manual', 'mine': 'application/x-troff-man'},
+    'me': {'application': 'readme text file', 'mine': 'application/x-troff-me'},
+    'ms': {'application': '3ds Max script file', 'mine': 'application/x-troff-ms'},
+    'ustar': {'application': 'uniform standard tape archive format file', 'mine': 'application/x-ustar'},
+    'src': {'application': 'source code', 'mine': 'application/x-wais-source'},
+    'cer': {'application': 'internet security certificate', 'mine': 'application/x-x509-ca-cert'},
+    'crt': {'application': 'security certificate', 'mine': 'application/x-x509-ca-cert'},
+    'der': {'application': 'DER certificate file', 'mine': 'application/x-x509-ca-cert'},
+    'pko': {'application': 'public key security object', 'mine': 'application/ynd.ms-pkipko'},
+    'zip': {'application': 'zipped file', 'mine': 'application/zip'},
+    'xhtml': {'application': '', 'mine': 'application/xhtml+xml'},  # Added in 07 Mar, 2024
+    # MIME Types: Sound Files
+    'au': {'application': 'audio file', 'mine': 'audio/basic'},
+    'snd': {'application': 'sound file', 'mine': 'audio/basic'},
+    'mid': {'application': 'midi file', 'mine': 'audio/mid'},
+    'rmi': {'application': 'media processing server studio', 'mine': 'audio/mid'},
+    'mp3': {'application': 'MP3 file', 'mine': 'audio/mpeg'},
+    'aif': {'application': 'audio interchange file format', 'mine': 'audio/x-aiff'},
+    'aifc': {'application': 'compressed audio interchange file', 'mine': 'audio/x-aiff'},
+    'aiff': {'application': 'audio interchange file format', 'mine': 'audio/x-aiff'},
+    'm3u': {'application': 'media playlist file', 'mine': 'audio/x-mpegurl'},
+    'ra': {'application': 'Real Audio file', 'mine': 'audio/x-pn-realaudio'},
+    'ram': {'application': 'Real Audio metadata file', 'mine': 'audio/x-pn-realaudio'},
+    'wav': {'application': 'WAVE audio file', 'mine': 'audio/x-wav'},
+    # MIME Types: Image Files
+    'png': {'application': 'png', 'mine': 'image/png'},
+    'bmp': {'application': 'Bitmap', 'mine': 'image/bmp'},
+    'cod': {'application': 'compiled source code', 'mine': 'image/cis-cod'},
+    'gif': {'application': 'graphic interchange format', 'mine': 'image/gif'},
+    'ief': {'application': 'image file', 'mine': 'image/ief'},
+    'jpe': {'application': 'JPEG image', 'mine': 'image/jpeg'},
+    'jpeg': {'application': 'JPEG image', 'mine': 'image/jpeg'},
+    'jpg': {'application': 'JPEG image', 'mine': 'image/jpeg'},
+    'jfif': {'application': 'JPEG file interchange format', 'mine': 'image/pipeg'},
+    'svg': {'application': 'scalable vector graphic', 'mine': 'image/svg+xml'},
+    'tif': {'application': 'TIF image', 'mine': 'image/tiff'},
+    'tiff': {'application': 'TIF image', 'mine': 'image/tiff'},
+    'ras': {'application': 'Sun raster graphic', 'mine': 'image/x-cmu-raster'},
+    'cmx': {'application': 'Corel metafile exchange image file', 'mine': 'image/x-cmx'},
+    'ico': {'application': 'icon', 'mine': 'image/x-icon'},
+    'pnm': {'application': 'portable any map image', 'mine': 'image/x-portable-anymap'},
+    'pbm': {'application': 'portable bitmap image', 'mine': 'image/x-portable-bitmap'},
+    'pgm': {'application': 'portable graymap image', 'mine': 'image/x-portable-graymap'},
+    'ppm': {'application': 'portable pixmap image', 'mine': 'image/x-portable-pixmap'},
+    'rgb': {'application': 'RGB bitmap', 'mine': 'image/x-rgb'},
+    'xbm': {'application': 'X11 bitmap', 'mine': 'image/x-xbitmap'},
+    'xpm': {'application': 'X11 pixmap', 'mine': 'image/x-xpixmap'},
+    'xwd': {'application': 'X-Windows dump image', 'mine': 'image/x-xwindowdump'},
+    # MIME Types: Virtual World Files
+    'flr': {'application': 'Flare decompiled actionscript file', 'mine': 'x-world/x-vrml'},
+    'vrml': {'application': 'VRML file', 'mine': 'x-world/x-vrml'},
+    'wrl': {'application': 'VRML world', 'mine': 'x-world/x-vrml'},
+    'wrz': {'application': 'compressed VRML world', 'mine': 'x-world/x-vrml'},
+    'xaf': {'application': '3ds max XML animation file', 'mine': 'x-world/x-vrml'},
+    'xof': {'application': 'Reality Lab 3D image file', 'mine': 'x-world/x-vrml'},
+    # MIME Types: Video Files
+    'mp2': {'application': 'MPEG-2 audio file', 'mine': 'video/mpeg'},
+    'mpa': {'application': 'MPEG-2 audio file', 'mine': 'video/mpeg'},
+    'mpe': {'application': 'MPEG movie file', 'mine': 'video/mpeg'},
+    'mpeg': {'application': 'MPEG movie file', 'mine': 'video/mpeg'},
+    'mpg': {'application': 'MPEG movie file', 'mine': 'video/mpeg'},
+    'mpv2': {'application': 'MPEG-2 video stream', 'mine': 'video/mpeg'},
+    'mp4': {'application': 'MPEG-4', 'mine': 'video/mp4'},
+    'mov': {'application': 'Apple QuickTime movie', 'mine': 'video/quicktime'},
+    'qt': {'application': 'Apple QuickTime movie', 'mine': 'video/quicktime'},
+    'lsf': {'application': 'Logos library system file', 'mine': 'video/x-la-asf'},
+    'lsx': {'application': 'streaming media shortcut', 'mine': 'video/x-la-asf'},
+    'asf': {'application': 'advanced systems format file', 'mine': 'video/x-ms-asf'},
+    'asr': {'application': 'ActionScript remote document', 'mine': 'video/x-ms-asf'},
+    'asx': {'application': 'Microsoft ASF redirector file', 'mine': 'video/x-ms-asf'},
+    'avi': {'application': 'audio video interleave file', 'mine': 'video/x-msvideo'},
+    'movie': {'application': 'Apple QuickTime movie', 'mine': 'video/x-sgi-movie'},
+    # MIME Types: Text Files
+    'css': {'application': 'Cascading Style Sheet', 'mine': 'text/css'},
+    '323': {'application': 'H.323 internet telephony file', 'mine': 'text/h323'},
+    'htm': {'application': 'HTML file', 'mine': 'text/html'},
+    'html': {'application': 'HTML file', 'mine': 'text/html'},
+    'stm': {'application': 'Exchange streaming media file', 'mine': 'text/html'},
+    'uls': {'application': 'NetMeeting user location service file', 'mine': 'text/iuls'},
+    'bas': {'application': 'BASIC source code file', 'mine': 'text/plain'},
+    'c': {'application': 'C/C++ source code file', 'mine': 'text/plain'},
+    'h': {'application': 'C/C++/Objective C header file', 'mine': 'text/plain'},
+    'txt': {'application': 'text file', 'mine': 'text/plain'},
+    'rtx': {'application': 'rich text file', 'mine': 'text/richtext'},
+    'sct': {'application': 'Scitext continuous tone file', 'mine': 'text/scriptlet'},
+    'tsv': {'application': 'tab separated values file', 'mine': 'text/tab-separated-values'},
+    'htt': {'application': 'hypertext template file', 'mine': 'text/webviewhtml'},
+    'htc': {'application': 'HTML component file', 'mine': 'text/x-component'},
+    'etx': {'application': 'TeX font encoding file', 'mine': 'text/x-setext'},
+    'vcf': {'application': 'vCard file', 'mine': 'text/x-vcard'},
+    'csv': {'application': '', 'mine': 'text/csv'},  # Added in 07 Mar, 2024
+    # MIME Types: Mail Message Files
+    'mht': {'application': 'MHTML web archive', 'mine': 'message/rfc822'},
+    'mhtml': {'application': 'MIME HTML file', 'mine': 'message/rfc822'},
+    'nws': {'application': 'Windows Live Mail newsgroup file', 'mine': 'message/rfc822'},
+}
+
+
+def get_content_type_v1(extension):
+    current_type = 'application/octet-stream'
+
+    try:
+        current_type = _content_file_mapping[extension]['mine']
+    except Exception as e:
+        pass
+
+    return current_type
+
+
+class _SingletonType(type):
+    _instance_lock = threading.Lock()
+
+    def __call__(cls, *args, **kwargs):
+        if not hasattr(cls, "_instance"):
+            with _SingletonType._instance_lock:
+                if not hasattr(cls, "_instance"):
+                    cls._instance = super(_SingletonType, cls).__call__(*args, **kwargs)
+        return cls._instance
+
+
+class _SwitchContentFileType(metaclass=_SingletonType):
+    def __init__(self):
+        self.content2file_type_mapping = {}
+        self.file2content_type_mapping = {}
+        # To load all mapping data
+        for key, value in _content_file_mapping.items():
+            # print(key, value['mine'])
+            self.file2content_type_mapping[key] = value['mine']
+            if value['mine'] in self.content2file_type_mapping:
+                self.content2file_type_mapping[value['mine']].append(key)
+            else:
+                self.content2file_type_mapping[value['mine']] = [key]
+
+    def content2file_type(self, content_type):
+        current_type = ['*']
+        try:
+            current_type = self.content2file_type_mapping[str(content_type).strip().lower()]
+        except Exception as e:
+            pass
+        return current_type
+
+    def file2content_type(self, file_type):
+        current_type = 'application/octet-stream'
+        try:
+            current_type = self.file2content_type_mapping[str(file_type).strip().lower()]
+        except Exception as e:
+            pass
+        return current_type
+
+
+def content2file_type(content_type):
+    switch_content_file_type = _SwitchContentFileType()
+    return switch_content_file_type.content2file_type(content_type)
+
+
+def file2content_type(file_type):
+    switch_content_file_type = _SwitchContentFileType()
+    return switch_content_file_type.file2content_type(file_type)
+
+
+# -------------------------------------------------------------------------------------------------------------
+# Below are the recommended methods
+# -------------------------------------------------------------------------------------------------------------
+
+def get_content_type_4_filename(filename: str, text_with_utf8=False):
+    # If no '.' in filename then get the full filename instead.
+    file_extension = filename.split('.')[-1]
+
+    try:
+        extension = _content_file_mapping[file_extension.strip().lower()]['mine']
+        if text_with_utf8 and extension.startswith('text/'):
+            extension += ';charset=utf-8'
+        return extension
+    except:
+        return 'application/octet-stream'

enconia_utils-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,12 @@
+enconia_utils/__init__.py,sha256=0WL5h1iPYVOdk64BMyLhzfDugzIkqfv9-dytW9YkapQ,1626
+enconia_utils/aliyun_sls_log.py,sha256=GplzITXhIavmbuqY1DL723me2z1aai5JmOdOn_vWBzY,4654
+enconia_utils/feishu_push.py,sha256=S1QWRPIImBuYLd4YXSDOFYa3Gnh1qFKybGjNfSVUefM,7089
+enconia_utils/id_generator.py,sha256=nOhb8bVvjuLnHUkM1KVcuRtf1y5Q80Yj1iz4upPkioM,4036
+enconia_utils/util_date.py,sha256=LRxr2UZ547M58OiMlsgx0nYVmqLF0ja0WvshvXiQE1Y,6361
+enconia_utils/util_oss.py,sha256=-tSZTlmrv_TVaCRuRBvi6Qhbvk7ouuk1LWvc3ZBQZfU,4704
+enconia_utils/util_type_mapping.py,sha256=4_BjV7DxqkJzwA2Wk6i4BVK7yVAgMNW8jfcORGJalsI,22821
+enconia_utils-0.1.0.dist-info/licenses/LICENSE,sha256=rvK14ealwAT47qkAKUdC8oIuyMTtqFbBRNOPGY8xdGg,1534
+enconia_utils-0.1.0.dist-info/METADATA,sha256=lHF6keCk0DCMPOX6TL3Ap2QdiOvMN8A2XRVf0Vrp1Ak,2387
+enconia_utils-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+enconia_utils-0.1.0.dist-info/top_level.txt,sha256=UuvM6oHnoSut2ivfT3sDExg-jYYWZnZ44uJNAM-f6dY,14
+enconia_utils-0.1.0.dist-info/RECORD,,

enconia_utils-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

enconia_utils-0.1.0.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+enconia_utils