pyxllib 0.3.96__py3-none-any.whl → 0.3.197__py3-none-any.whl

pyxllib/prog/newbie.py

@@ -28,7 +28,7 @@ class SingletonForEveryClass(type):
 
 
 class SingletonForEveryInitArgs(type):
-    """Python单例模式(Singleton)的N种实现 - 知乎: https://zhuanlan.zhihu.com/p/37534850
+    """ Python单例模式(Singleton)的N种实现 - 知乎: https://zhuanlan.zhihu.com/p/37534850
 
     注意！注意！注意！重要的事说三遍！
     这里的单例类不是传统意义上的单例类。
@@ -259,6 +259,9 @@ def human_readable_number(value, base_type='K', precision=4):
     :param str base_type: 进制类型，'K'为1000进制, 'KB'为1024进制（KiB同理）, '万'为中文万进制
     :return: 美化后的字符串
     """
+    if value is None:
+        return ''
+
     if abs(value) < 1:
         return f'{value:.{precision}g}'
 
@@ -267,13 +270,17 @@ def human_readable_number(value, base_type='K', precision=4):
         'K': (['', 'K', 'M', 'G', 'T', 'P', 'E', 'Z', 'Y'], 1000),
         'KB': (['', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'], 1024),
         'KiB': (['', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'], 1024),
-        '万': (['', '万', '亿', '万亿', '亿亿'], 10000)
+        '万': (['', '万', '亿', '万亿', '亿亿'], 10000),
+        '秒': (['秒', [60, '分'], [60, '时'], [24, '天'], [7, '周'], [4.345, '月'], [12, '年']], 60),
     }.get(base_type, ([''], 1))  # 默认为空单位和基数1
 
     x, i = abs(value), 0
     while x >= base and i < len(units) - 1:
         x /= base
         i += 1
+        if isinstance(units[i], list):
+            base = units[i][0]
+            units[i] = units[i][1]
 
     x = f'{x:.{precision}g}'  # 四舍五入到指定精度
     prefix = '-' if value < 0 else ''  # 负数处理

pyxllib/prog/pupil.py

@@ -6,10 +6,11 @@
 
 
 """ 封装一些代码开发中常用的功能，工程组件 """
-import builtins
-from collections import Counter, UserDict
+
+from collections import Counter
 from concurrent.futures import ThreadPoolExecutor
-import ctypes
+from urllib.parse import urlparse
+import builtins
 import datetime
 import functools
 import hashlib
@@ -23,20 +24,22 @@ import os
 import pprint
 import queue
 import random
+import re
 import signal
 import socket
-import socketserver
 import subprocess
 import sys
 import tempfile
 import threading
 import time
 import traceback
-from urllib.parse import urlparse
 
 from pyxllib.prog.newbie import classproperty, typename
 
 
+# from loguru import logger
+
+
 def system_information():
     """主要是测试一些系统变量值，顺便再演示一次Timer用法"""
 
@@ -554,6 +557,9 @@ class Timeout:
         return wrapper
 
     def __enter__(self):
+        if self.seconds == 0:  # 可以设置0来关闭超时功能
+            return
+
         def overtime(signum, frame):
             raise TimeoutError(f'with 上下文代码块运行超时 > [{self.seconds} 秒]')
 
@@ -567,6 +573,9 @@ class Timeout:
         self.alarm.start()
 
     def __exit__(self, exc_type, exc_val, exc_tb):
+        if self.seconds == 0:
+            return
+
         # with已经运行完了，马上关闭警告器
         self.alarm.cancel()
 
@@ -595,6 +604,7 @@ def inject_members(from_obj, to_obj, member_list=None, *,
     # 把XlDocxTable的成员方法绑定到docx.table.Table里
     >> inject_members(XlDocxTable, docx.table.Table)
 
+    240826周一，其他可参考学习的三方现成工具库：from fastcore.foundation import patch
     """
     # 1 整理需要注入的方法清单
     dst = set(dir(to_obj))
@@ -622,20 +632,6 @@ def inject_members(from_obj, to_obj, member_list=None, *,
             logging.warning(f'Conflict of the same name! {to_obj}.{x}')
 
 
-def find_free_ports(count=1):
-    """ 随机获得可用端口
-
-    :param count: 需要的端口数量（会保证给出的端口号不重复）
-    :return: list
-    """
-    ports = set()
-    while len(ports) < count:
-        with socketserver.TCPServer(("localhost", 0), None) as s:
-            ports.add(s.server_address[1])
-
-    return list(ports)
-
-
 def __debug系列():
     pass
 
@@ -972,47 +968,6 @@ class OutputLogger(logging.Logger):
         self.print(msg)
 
 
-class MultiProcessLauncher:
-    """ 注意这个类暂时只有linux能使用 """
-
-    def __init__(self):
-        self.workers = []
-
-    def add_process(self, cmd, name=None, **kwargs):
-        if name is None:
-            name = cmd.split()[0]
-
-        p = subprocess.Popen(cmd.split(), preexec_fn=self._set_pdeathsig(signal.SIGTERM))
-        worker = {'name': name, 'process': p, 'command': cmd}
-        worker.update(kwargs)
-        self.workers.append(worker)
-
-    def add_python_module(self, module, args='', name=None):
-        """ 添加并启动一个Python模块作为后台进程。
-
-        :param module: 要执行的Python模块名（python -m 后面的部分）
-        :param args: 模块的参数
-        :param name: 进程的名称，默认为模块名
-        """
-        cmd = f'{sys.executable} -m {module} {args}'
-        self.add_process(cmd, name=name)
-
-    def stop_all(self):
-        """ 停止所有后台进程 """
-        for worker in self.workers:
-            worker.process.terminate()
-        self.workers = []
-
-    def _set_pdeathsig(self, sig=signal.SIGTERM):
-        """ 在主服务退出时，这些进程也会全部自动关闭 """
-
-        def callable():
-            libc = ctypes.CDLL("libc.so.6")
-            return libc.prctl(1, sig)
-
-        return callable
-
-
 def xlmd5(content):
     if isinstance(content, str):
         content = content.encode('utf-8')
@@ -1095,6 +1050,8 @@ def safe_div(a, b):
 
 def inplace_decorate(parent, func_name, wrapper):
     """ 将指定的函数替换为装饰器版本
+    允许在运行时动态地将一个函数或方法替换为其装饰版本。通常用于添加日志、性能测试、事务处理等。
+    （既然可以写成装饰版本，相当于其实要完全替换成另外的函数也是可以的）
 
     当然，因为py一切皆对象，这里处理的不是函数，而是其他变量等对象也是可以的
 
@@ -1126,3 +1083,115 @@ def inplace_decorate(parent, func_name, wrapper):
             return wrapper(original_func, *args, **kwargs)
 
         parent[func_name] = decorated_func
+
+
+def check_counter(data, top_n=10):
+    """ 将一个数据data转为Counter进行频数分析 """
+    # 1 如果是list、tuple类型，需要转counter
+    if isinstance(data, (list, tuple)):
+        data = Counter(data)
+    if not isinstance(data, Counter):
+        raise ValueError(f'输入的数据类型不对，应该是Counter类型，而不是{typename(data)}')
+
+    # 2 列出出现次数最多的top_n条目
+    # 打印基本统计信息
+    total_items = sum(data.values())
+    print(f"总条目数: {total_items}")
+
+    if top_n > 0:
+        top_items = data.most_common(top_n)
+        max_n = len(data)
+        print(f"出现次数最多的{min(top_n, max_n)}/{max_n}条数据（频率）:")
+        for item, count in top_items:
+            print(f"\t{item}\t{count}")
+
+    # 3 打印基本统计信息
+    # 对原始Counter的计数值进行再计数
+    count_frequencies = Counter(data.values())
+
+    # 打印各计数值出现的次数
+    print("各计数值出现的次数，频率的频率（频率分布）:")
+    for count, frequency in count_frequencies.most_common():
+        print(f"\t{count}\t{frequency}")
+
+
+def tprint(*args, **kwargs):
+    """ 带时间戳的print """
+    print(utc_now2(), *args, **kwargs)
+
+
+def is_valid_identifier(name):
+    """ 判断是否是合法的标识符 """
+    return re.match(r'^[a-zA-Z_][a-zA-Z0-9_]*$', name)
+
+
+def get_number_width(n):
+    """ 判断数值n的长度
+
+    参考资料：https://jstrieb.github.io/posts/digit-length/
+
+    >>> get_number_width(0)
+    1
+    >>> get_number_width(9)
+    1
+    >>> get_number_width(10)
+    2
+    >>> get_number_width(97)
+    2
+    """
+    # assert n > 0
+    # return math.ceil(math.log10(n + 1))
+
+    return 1 if n == 0 else (math.floor(math.log10(n)) + 1)
+
+
+def aligned_range(start, stop=None, step=1):
+    """ 返回按照域宽对齐的数字序列 """
+    if stop is None:
+        start, stop = 0, start
+
+    max_width = get_number_width(stop - step)
+    format_str = '{:0' + str(max_width) + 'd}'
+
+    return [format_str.format(i) for i in range(start, stop, step)]
+
+
+def percentage_and_value(numbers, precision=2, *, total=None, sep='.'):
+    """ 对输入的一串数值，转换成一种特殊的表达格式 "百分比.次数"
+
+    :param list numbers: 数值列表
+    :param int precision: 百分比的精度（小数点后的位数），默认为 2
+    :param int total: 总数，如果不输入，则默认为输入数值的和
+    :param str sep: 分隔符
+    :return: 整数部分是比例，小数部分是原始数值的整数部分
+    """
+    if total is None:
+        total = sum(numbers)
+    width = get_number_width(total)
+    result = []
+    for num in numbers:
+        percent = safe_div(num, total) * 10 ** precision
+        result.append(f"{percent:.0f}{sep}{num:0{width}d}")
+    return result
+
+
+def get_local_ip():
+    """ 获得本地ip，代码由deepseek提供 """
+    try:
+        # 使用UDP协议连接到外部服务器
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.connect(("8.8.8.8", 80))  # Google的DNS服务器和常用端口
+        local_ip = s.getsockname()[0]  # 获取套接字的本地地址
+        s.close()
+        return local_ip
+    except Exception as e:
+        # 如果失败，尝试通过主机名获取IP列表
+        try:
+            hostname = socket.gethostname()
+            ips = socket.gethostbyname_ex(hostname)[2]  # 获取所有IPv4地址
+            for ip in ips:
+                if ip != "127.0.0.1":  # 排除回环地址
+                    return ip
+            return "127.0.0.1"  # 默认返回回环地址
+        except:
+            raise ValueError("无法获取IP地址")

pyxllib/prog/specialist/__init__.py

@@ -25,7 +25,7 @@ import requests
 from humanfriendly import parse_size
 
 from pyxllib.prog.newbie import human_readable_size
-from pyxllib.prog.pupil import get_installed_packages
+from pyxllib.prog.pupil import get_installed_packages, aligned_range, percentage_and_value
 from pyxllib.prog.xlosenv import XlOsEnv
 from pyxllib.file.specialist import cache_file
 
@@ -102,6 +102,7 @@ def distribute_package(root, version=None, repository=None, *,
     :param version_file: 保存版本号的文件，注意看正则规则，需要满足特定的范式，才会自动更新版本号
     :param delete_dist: 上传完是否自动删除dist目录，要检查上传包是否有遗漏时，要关闭
     """
+    import sys
     from pyxllib.file.specialist import XlPath
 
     # 1 切换工作目录
@@ -114,7 +115,7 @@ def distribute_package(root, version=None, repository=None, *,
         f.write_text(s)
 
     # 3 打包
-    subprocess.run('python setup.py sdist bdist_wheel')
+    subprocess.run(f'{sys.executable} setup.py sdist')
 
     # 4 上传
     if upload:
@@ -215,3 +216,176 @@ class ProgressBar:
                 time.sleep(1)
             pbar.n = self.progress
             pbar.refresh()
+
+
+class BitMaskTool:
+    """ 二进制位掩码工具
+
+    概念术语
+        bitval，每一个位上的具体取值，0或1
+        bitsum，所有位上的取值的和，即二进制数的十进制表示
+    """
+
+    def __init__(self, bit_names=None, bitsum_counter=None):
+        """ 初始化 BitMaskTool 对象
+
+        :param list bit_names: 每一位功能开启时，显示的标签名。未输入时，填充0,1,2,3...注意总数，要按域宽对齐
+        :param dict/list bitsum_counter: 各种值出现的次数，可以是一个字典或者一个包含出现次数的列表
+        """
+        # 1 每一位功能开启时，显示的标签名。未输入时，填充0,1,2,3...注意总数，要按域宽对齐
+        if bit_names is None:
+            bit_names = list(aligned_range(len(bit_names)))
+        self.bit_names = bit_names
+        # 2 各种值出现的次数
+        if isinstance(bitsum_counter, (list, tuple)):
+            bitsum_counter = Counter(bitsum_counter)
+        self.bitsum_counter = bitsum_counter or {}
+
+    def get_bitsum_names(self, bitsum):
+        """ 从bitsum得到names的拼接
+
+        >> get_bitsum_names(3)
+        '语义定位,图表'
+        """
+        if not isinstance(bitsum, int):
+            try:
+                bitsum = int(bitsum)
+            except ValueError:
+                bitsum = 0
+
+        tags = []
+        for i, k in enumerate(self.bit_names):
+            if (1 << i) & bitsum:
+                tags.append(k)
+        return ','.join(tags)
+
+    def count_bitsum_relations(self, target_bitsum, relation='='):
+        """ 计算特定关系的 bitsum 数量
+
+        :param int target_bitsum: 目标 bitsum
+        :param str relation: 关系类型，可以是 '=', '⊂', '⊃'
+            假设bitval对应的bit_names为n1,n2,n3,n4。
+            那么bitsum相当于是bitval的一个集合
+            比如a={n1,n3,n4}，b={n1,n3}，因为a完全包含b，所以认为a⊃b，或者a⊋b、b⊂a、b⊊a
+        :return int: 符合条件的 bitsum 数量
+        """
+        count = 0
+        if relation == '=':
+            # 直接计算等于 target_bitsum 的数量
+            count = self.bitsum_counter.get(target_bitsum, 0)
+        elif relation == '⊂':
+            # 计算所有被 target_bitsum 包含的 bitsum 的数量
+            for bitsum, num in self.bitsum_counter.items():
+                if bitsum and bitsum & target_bitsum == bitsum:
+                    count += num
+        elif relation == '⊃':
+            # 计算所有包含 target_bitsum 的 bitsum 的数量
+            for bitsum, num in self.bitsum_counter.items():
+                if bitsum & target_bitsum == target_bitsum:
+                    count += num
+        return count
+
+    def check_bitflag(self, max_bitsum_len=None, reletion='=',
+                      filter_zero=False, sort_by=None, *,
+                      min_bitsum_len=0):
+        """ 检查并返回 bitsum 关系的 DataFrame
+
+        :param int max_bitsum_len: 最大 bitsum 长度
+        :param str reletion: 关系类型，可以是 '=', '⊂', '⊃'
+            支持输入多个字符，表示要同时计算多种关系
+        :param bool filter_zero: 是否过滤掉零值
+        :param None|str sort_by: 排序字段
+            None, 默认排序
+            count, 按照数量从大到小排序
+            bitsum, 按照 bitsum 从小到大排序
+        :param int min_bitsum_len: 最小 bitsum 长度
+        :return: 包含 bitsum 关系的 DataFrame
+        """
+        from itertools import combinations
+
+        total = sum(self.bitsum_counter.values())
+        rows, columns = [], ['类型', '名称', '百分比.次数']
+        rows.append([-1, '总计', total])
+
+        if max_bitsum_len is None:
+            max_bitsum_len = len(self.bit_names)
+
+        bitvals = [(1 << i) for i in range(len(self.bit_names))]
+        for m in range(min_bitsum_len, max_bitsum_len + 1):
+            for comb in combinations(bitvals, m):
+                bitsum = sum(comb)
+                count = self.count_bitsum_relations(bitsum, relation=reletion)
+                if filter_zero and count == 0:
+                    continue
+                rows.append([f'{reletion}{bitsum}',
+                             self.get_bitsum_names(bitsum),
+                             count])
+
+        if sort_by == 'count':
+            rows.sort(key=lambda x: x[2], reverse=True)
+        elif sort_by == 'bitsum':
+            rows.sort(key=lambda x: int(x[0][1:]) if isinstance(x[0], str) else x[0])
+
+        df = pd.DataFrame.from_records(rows, columns=columns)
+        df['百分比.次数'] = percentage_and_value(df['百分比.次数'], 2, total=total)
+        return df
+
+    def report(self):
+        """ 生成统计报告 """
+        html_content = []
+
+        html_content.append('<h1>1 包含每一位bitval特征的数量</h1>')
+        df1 = self.check_bitflag(1, '⊃')
+        html_content.append(df1.to_html())
+
+        html_content.append('<h1>2 每一种具体bitsum组合的数量</h1>')
+        df2 = self.check_bitflag(reletion='=', filter_zero=True, sort_by='bitsum')
+        html_content.append(df2.to_html())
+
+        return '\n'.join(html_content)
+
+
+def loguru_setup_jsonl_logfile(logger, log_dir, rotation_size="10 MB"):
+    """
+    给loguru的日志器添加导出文件的功能，使用jsonl格式
+
+    :param logger: 日志记录器，一般是from loguru import logger的logger
+    :param log_dir: 存储日志的目录，因为有多个文件，这里要输入的是所在的目录
+    :param rotation_size: 文件多大后分割
+    :return:
+    """
+    from datetime import datetime
+
+    os.makedirs(log_dir, exist_ok=True)  # 自动创建日志目录
+
+    # 日志文件名匹配的正则表达式，格式为 年月日_时分秒.log
+    log_filename_pattern = re.compile(r"(\d{8}_\d{6})\.jsonl")
+
+    # 找到最新的日志文件
+    def find_latest_log_file(log_dir):
+        log_files = []
+        for file in os.listdir(log_dir):
+            if log_filename_pattern.match(file):
+                log_files.append(file)
+
+        if log_files:
+            # 根据时间排序，选择最新的日志文件
+            log_files.sort(reverse=True)
+            return os.path.join(log_dir, log_files[0])
+        return None
+
+    # 检查是否有未写满的日志文件
+    latest_log_file = find_latest_log_file(log_dir)
+
+    if latest_log_file:
+        log_path = latest_log_file
+    else:
+        # 生成新的日志文件名
+        log_filename = datetime.now().strftime("%Y%m%d_%H%M%S") + ".jsonl"
+        log_path = os.path.join(log_dir, log_filename)
+
+    # 配置 logger，写入日志文件，设置旋转条件，使用 JSON 序列化
+    logger.add(log_path, rotation=rotation_size, serialize=True)
+
+    # 输出初始化成功信息
+    logger.info(f"日志系统已初始化，日志文件路径：{log_path}")

pyxllib/prog/specialist/bc.py

@@ -16,7 +16,10 @@ from pyxllib.file.specialist import File, Dir, filesmatch, get_encoding, XlPath
 # BCompare.exe， bcompare函数要用
 
 class BCompare(Explorer):
-    def __init__(self, app='BCompare', shell=False):
+    def __init__(self, app='bcomp', shell=False):
+        """
+        240512周日20:06，本来写的是BCompare，但是友鑫mac电脑上发现似乎有问题，所以改成bcomp，这种在windows上也能用
+        """
         super().__init__(app, shell)
 
     @classmethod
@@ -48,7 +51,7 @@ class BCompare(Explorer):
         default_suffix = None
         for i, arg in enumerate(args):
             f = XlPath.safe_init(arg)
-            if f.is_file():  # 是文件对象，且存在
+            if f is not None and f.is_file():  # 是文件对象，且存在
                 new_args.append(f)
                 if not default_suffix:
                     default_suffix = f.suffix

pyxllib/prog/specialist/browser.py

@@ -13,6 +13,7 @@ import subprocess
 import sys
 import datetime
 import platform
+import re
 
 import pandas as pd
 from bs4 import BeautifulSoup
@@ -118,9 +119,12 @@ class Explorer:
         TODO 获得返回值分析
         """
         args = [self.app] + list(args)
+
         if 'shell' not in kwargs:
             kwargs.update({'shell': self.shell})
-
+        if re.match(r'open\s', self.app):
+            args = args[0] + ' ' + args[1]
+            kwargs.update({'shell': True})
         try:
             if wait:
                 subprocess.run(args, **kwargs)
@@ -161,6 +165,7 @@ class Browser(Explorer):
                 # 这里默认设置为 'google-chrome'，如果你想使用其他的浏览器，例如Firefox，可以修改为 'firefox'
                 app = 'google-chrome'
             else:
+                app = 'open -a "Google Chrome"'
                 # 其他系统的处理
                 pass
         super().__init__(app, shell)
@@ -225,6 +230,9 @@ class Browser(Explorer):
             file = file.rename(get_etag(str(file)) + file.suffix, if_exists='replace')
         self.__call__(arg, file, **kwargs)
 
+    def url(self, *args, wait=True, **kwargs):
+        super().__call__(*args, wait=wait, **kwargs)
+
     def __call__(self, arg, file=None, *, wait=True, clsmsg=True, to_html_args=None,
                  **kwargs):  # NOQA Browser的操作跟标准接口略有差异
         """ 该版本会把arg转存文件重设为文件名
@@ -232,7 +240,8 @@ class Browser(Explorer):
         :param file: 默认可以不输入，会按七牛的etag哈希值生成临时文件
             如果输入，则按照指定的名称生成文件
         """
-        if XlPath.safe_init(arg).is_file():
+        f = XlPath.safe_init(arg)
+        if f is not None and f.is_file():
             file = arg
         else:
             file = str(self.to_brower_file(arg, file, clsmsg=clsmsg, to_html_args=to_html_args))

pyxllib/prog/specialist/datetime.py

@@ -16,6 +16,8 @@ a = a - a.isoweekday() + kwargs['weekday']  # 先减去当前星期几，再加
 import datetime
 import re
 
+from fastcore.utils import GetAttr
+
 
 def parse_datetime(*argv):
     """ 解析字符串日期时间
@@ -29,6 +31,9 @@ def parse_datetime(*argv):
     >>> parse_datetime('w200301周日', 'w%y%m%d周日')  # 周日必须写全，有缺失会报ValueError
     datetime.datetime(2020, 3, 1, 0, 0)
 
+    >>> parse_datetime('2019.3.6 22:30:40')
+    datetime.datetime(2019, 3, 6, 22, 30, 40)
+
     >>> parse_datetime(180213)
     datetime.datetime(2018, 2, 13, 0, 0)
     >>> parse_datetime('180213')
@@ -99,6 +104,11 @@ def parse_datetime(*argv):
     # 1 没有参数则默认当前运行时间
     if not argv:
         dt = datetime.datetime.now()
+    if not dt and isinstance(argv[0], datetime.datetime):
+        dt = argv[0]
+    if not dt and isinstance(argv[0], datetime.date):
+        # 要转成datetime类型，time部分默认00:00:00
+        dt = datetime.datetime.combine(argv[0], datetime.time())
     if not dt and isinstance(argv[0], float):
         dt = datetime.datetime.fromtimestamp(argv[0])
     # 2 如果上述解析不了，且argv恰好为两个参数，则判断为使用strptime初始化
@@ -129,3 +139,61 @@ def parse_timedelta(s):
     d = {k: int(v) for k, v in zip(['seconds', 'minutes', 'hours'], parts)}
     td = datetime.timedelta(**d)
     return td
+
+
+class XlWeekTag(GetAttr):
+    """ 个人周标签转换工具 """
+    _default = 'dt'
+
+    def __init__(self, dt=None):
+        """
+        :param datetime|其他类日期表达 dt: 可以输入一个日期，默认为今天
+        """
+        if dt is None:
+            dt = datetime.date.today()
+        self.dt = parse_datetime(dt)
+
+    def __1_日期移动(self):
+        pass
+
+    def add_days(self, days):
+        """ 增加指定天数，支持负数 """
+        return self.__class__(self.dt + datetime.timedelta(days=days))
+
+    def monday(self):
+        """ 移动到本周周一 """
+        return self.add_days(-self.dt.weekday())
+
+    def next_week(self):
+        """ 移动到下一周 """
+        return self.add_days(7)
+
+    def prev_week(self):
+        """ 移动到上一周 """
+        return self.add_days(-7)
+
+    def __2_生成标签(self):
+        pass
+    
+    def weektag(self):
+        """
+        :return: 周标签名，例如 'w250414'，表示所属周的周一是2025年4月14日
+        """
+        monday = self.monday()  # 获取本周周一
+        tag = 'w' + monday.strftime('%y%m%d')
+        return tag
+
+    def daytag(self):
+        """
+        :return: 日标签名，例如 '250415周二'，表示当天的日期标记，一般是语雀周报中使用
+        """
+        ch = '一二三四五六日'[self.dt.weekday()]
+        tag = self.dt.strftime('%y%m%d') + '周' + ch
+        return tag
+
+    def week_daytags(self):
+        # 循环获得本周每天的daytag
+        monday = self.monday()
+        tags = [monday.add_days(i).daytag() for i in range(7)]
+        return tags
+