xstt 2026.4.23__tar.gz

xstt-2026.4.23/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: xstt
+Version: 2026.4.23
+Summary: 一些终端实用命令行工具
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: python-pyper
+Requires-Dist: rich
+Requires-Dist: typer-slim[standard]
+Requires-Dist: rapidfuzz
+Requires-Dist: pypinyin

xstt-2026.4.23/book_mark.py

@@ -0,0 +1,208 @@
+"""
+Author: xiash$
+Date: 2025/10/19$
+Project: terminal_tools$
+Description: $
+***
+* _ooOoo_
+* o8888888o
+* 88" . "88
+* (| -_- |)
+*  O\ = /O
+* ___/`---'\____
+* .   ' \\| |// `.
+* / \\||| : |||// \
+* / _||||| -:- |||||- \
+* | | \\\ - /// | |
+* | \_| ''\---/'' | |
+* \ .-\__ `-` ___/-. /
+* ___`. .' /--.--\ `. . __
+* ."" '< `.___\_<|>_/___.' >'"".
+* | | : `- \`.;`\ _ /`;.`/ - ` : | |
+* \ \ `-. \_ __\ /__ _/ .-` / /
+* ======`-.____`-.___\_____/___.-`____.-'======
+* `=---='
+*          .............................................
+*           佛曰：bug泛滥，我已瘫痪！
+"""
+import json
+import typer
+from pypinyin import lazy_pinyin, Style
+from rapidfuzz import process, fuzz
+from pathlib import Path
+from rich import print
+from typing import Iterable
+
+CONFIG_PATH = Path.home() / '.bookmarks/config.ini'
+
+
+def parse_browser_bookmarks(bookmark_files_path: str | Path | Iterable[Path | str]) -> list[dict]:
+    if isinstance(bookmark_files_path, (Path, str)):
+        bookmark_files_path = [bookmark_files_path]
+    bookmarks = []
+
+    def traverse_nodes(node):
+        if node.get('type') == 'url':
+            bookmarks.append({
+                'title': node.get('name', ''),
+                'url': node.get('url', '')
+            })
+        elif node.get('type') == 'folder':
+            for child in node.get('children', []):
+                traverse_nodes(child)
+
+    for bookmark_file in bookmark_files_path:
+        bookmark_file = Path(str(bookmark_file).strip())
+        if not bookmark_file.exists():
+            continue
+        with open(bookmark_file.as_posix().strip(), 'r', encoding='utf-8') as f:
+            data = json.load(f)
+
+        # 遍历所有根节点 (书签栏, 其他书签等)
+        for root_key in data.get('roots', {}):
+            traverse_nodes(data['roots'][root_key])
+
+    return bookmarks
+
+
+def get_search_keys(text: str) -> list[str]:
+    """
+    为一段文本（例如书签标题）生成所有可能的搜索键。
+    """
+    if not text:
+        return []
+
+    # 确保文本是字符串，pypinyin 处理非中文字符时会原样返回
+    text_lower = str(text).lower()
+
+    # 1. 原始关键字 (小写)
+    keys = [text_lower]
+
+    # 2. 全拼音 (例如: "zhongguoyinhang")
+    # style=Style.NORMAL: 普通拼音，不带声调
+    # errors='ignore': 忽略无法转换的字符（如特殊符号）
+    pinyin_full = "".join(lazy_pinyin(text, style=Style.NORMAL, errors='ignore'))
+    if pinyin_full != text_lower:
+        keys.append(pinyin_full)
+
+    # 3. 拼音首字母 (例如: "zgyh")
+    # style=Style.FIRST_LETTER: 拼音首字母
+    pinyin_initials = "".join(lazy_pinyin(text, style=Style.FIRST_LETTER, errors='ignore'))
+    if pinyin_initials != text_lower:
+        keys.append(pinyin_initials)
+
+    return keys
+
+
+def build_search_index(bookmarks: list[dict]):
+    """
+    构建用于 rapidfuzz 搜索的扁平化索引。
+
+    返回:
+    - search_choices (list[str]): 所有可能的搜索键的扁平列表
+    - index_map (dict[int, int]): search_choices的索引 -> bookmarks列表的索引
+    """
+    search_choices = []
+    index_map = {}  # key: 索引 in search_choices, value: 索引 in bookmarks
+
+    for bookmark_index, bookmark in enumerate(bookmarks):
+        # 我们主要搜索标题，也可以加入URL
+        title = bookmark.get('title', '')
+        url = bookmark.get('url', '')
+
+        # 为标题生成搜索键
+        title_keys = get_search_keys(title)
+
+        # (可选) 为URL的域名部分生成搜索键
+        # url_keys = get_search_keys(url.split('/')[2] if '/' in url else url)
+        # all_keys = title_keys + url_keys
+
+        all_keys = title_keys
+
+        for key in all_keys:
+            if key:  # 确保键不为空
+                search_choices.append(key)
+                index_map[len(search_choices) - 1] = bookmark_index
+
+    return search_choices, index_map
+
+
+def search_bookmarks(
+        query: str,
+        bookmarks: list[dict],
+        search_choices: list[str],
+        index_map: dict[int, int],
+        limit: int = 10,
+        score_threshold: int = 50
+):
+    """
+    使用 rapidfuzz 进行模糊搜索
+    """
+    query_lower = query.lower()
+
+    # rapidfuzz.process.extract() 是核心！
+    # 它会返回一个列表: [(匹配到的键, 匹配分数, 在search_choices中的索引), ...]
+    # 我们选择一个适合路径和缩写的计分器，如 WPath
+    # 我们多搜索一些结果 (limit * 3)，因为多个键可能指向同一个书签
+    results = process.extract(
+        query_lower,
+        search_choices,
+        scorer=fuzz.WRatio,  # WPath 计分器对缩写和顺序错乱有较好支持
+        limit=limit
+    )
+    for (matched_key, score, key_index) in results:
+        # 1. 通过映射表找到原始书签的索引
+        bookmark_index = index_map[key_index]
+
+        # 2. 检查是否已经添加过这个书签（避免重复）
+        if score > score_threshold:
+            # 3. 获取原始书签
+            bookmark = bookmarks[bookmark_index]
+            yield f'{bookmark["title"]}：{bookmark["url"]}'
+
+
+def bookmarks_search(
+        query: str = typer.Argument('', help="书签查询关键字"),
+        import_bookmarks_file: Path = typer.Option(None, '-i', '--import', help="书签文件路径"),
+        limit: int = typer.Option(10, '-l', '--limit', min=1, help='限制查询得数量'),
+        score: int = typer.Option(50, '-s', '--score', min=0, max=99, help='分数阈值，[0,99]之间')
+):
+    """
+    浏览器书签搜索
+    """
+    default_bookmarks_file = Path.home() / r'AppData/Local/Microsoft/Edge/User Data/Default/Bookmarks'
+    CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
+    f = open(CONFIG_PATH, 'a+')
+    f.seek(0)
+    bookmarks_files = set(line.strip() for line in f if line.strip())
+    if not bookmarks_files:
+        if default_bookmarks_file.exists():
+            bookmarks_files.add(default_bookmarks_file)
+            f.write(default_bookmarks_file.as_posix() + '\n')
+        else:
+            print(f'[yellow]{default_bookmarks_file} 不存在，请通过 --import 参数手动导入浏览器书签文件路径！')
+
+    if import_bookmarks_file:
+        if import_bookmarks_file.as_posix() in bookmarks_files:
+            print(f'[yellow]{import_bookmarks_file} 已配置过，无需重复导入！')
+        elif import_bookmarks_file.exists():
+            bookmarks_files.add(import_bookmarks_file)
+            f.write(import_bookmarks_file.as_posix() + '\n')
+            print(f'[green]{import_bookmarks_file} 导入成功！')
+        else:
+            print(f'[yellow]{import_bookmarks_file} 不存在！')
+    f.close()
+    if query:
+        bookmarks = parse_browser_bookmarks(bookmarks_files)
+        choices, mapping = build_search_index(bookmarks)
+        results = search_bookmarks(query, bookmarks, choices, mapping, limit, score)
+        for result in results:
+            print(result)
+
+
+def main():
+    typer.run(bookmarks_search)
+
+
+if __name__ == '__main__':
+    main()

xstt-2026.4.23/disk_usage.py

@@ -0,0 +1,305 @@
+"""
+Author: xiash$
+Date: 2025/5/11$
+Project: terminal_tools$
+Description: $
+***
+* _ooOoo_
+* o8888888o
+* 88" . "88
+* (| -_- |)
+*  O\ = /O
+* ___/`---'\____
+* .   ' \\| |// `.
+* / \\||| : |||// \
+* / _||||| -:- |||||- \
+* | | \\\ - /// | |
+* | \_| ''\---/'' | |
+* \ .-\__ `-` ___/-. /
+* ___`. .' /--.--\ `. . __
+* ."" '< `.___\_<|>_/___.' >'"".
+* | | : `- \`.;`\ _ /`;.`/ - ` : | |
+* \ \ `-. \_ __\ /__ _/ .-` / /
+* ======`-.____`-.___\_____/___.-`____.-'======
+* `=---='
+*          .............................................
+*           佛曰：bug泛滥，我已瘫痪！
+"""
+import argparse
+import json
+import os
+import os.path as osp
+import platform
+from copy import deepcopy
+from pathlib import Path
+from pyper import task
+from typing import Tuple, Iterable
+from rich import print
+from rich.text import Text
+from rich.progress import Progress, TimeElapsedColumn, MofNCompleteColumn
+
+cache_dir = os.environ.get('DISK_USAGE_CACHE_DIR', Path.home() / '.disk_usage')
+disk_usage_cache = {}
+
+
+def total_st_size(path: Path | str) -> Tuple[int, Path]:
+    """
+    获取文件或目录(包括所有子目录及文件)大小
+    :param path:
+    :return:
+    """
+    path = Path(path)
+    if path.is_file():
+        return file_st_size(path), path
+    elif path.is_symlink():
+        return 0, Path(f"{path}(-> {path.readlink()})")
+    elif path.is_dir():
+        st_mtime = path.stat().st_mtime
+        key_path = osp.abspath(path)
+        cache_info = disk_usage_cache.get(key_path)
+        if cache_info and st_mtime == cache_info[1]:
+            size = cache_info[0]
+        else:
+            # size = sum(st_size(file) for file in path.iter_dir(recursive=True))
+            try:
+                # size = dir_total_size(path)
+                size = dir_total_size_parallel(path)
+            except Exception as e:
+                # print(f"[red]警告：无法访问 {path}，错误：{e}")
+                size = 0
+            disk_usage_cache[key_path] = (size, st_mtime)
+        return size, path
+    return 0, path
+
+
+def dir_total_size_parallel(src: str | Path) -> int:
+    """
+    获取目录下所有文件的大小总和，一级子目录并行进行统计
+    :param src:
+    :return:
+    """
+    src = Path(src)
+    total_num = sum(file_st_size(file) for file in src.iterdir() if file.is_file())
+    workers = min(4, sum(1 for file in os.scandir(src) if file.is_dir()))
+    if workers == 0:
+        return total_num
+    pipeline = (
+            task(lambda path: (file for file in path.iterdir() if file.is_dir()), branch=True) |
+            task(dir_total_size, workers=workers, multiprocess=True)
+    )
+    for num in pipeline(src):
+        total_num += num
+    return total_num
+
+
+def dir_total_size(src_dir):
+    src_dir = Path(src_dir)
+    if src_dir.is_symlink():
+        return 0
+    st_mtime = src_dir.stat().st_mtime
+    key_path = osp.abspath(src_dir)
+    cache_info = disk_usage_cache.get(key_path)
+    if cache_info and st_mtime == cache_info[1]:
+        return cache_info[0]
+    return sum(
+        sum(map(lambda file: file_st_size(osp.join(walk_out[0], file)), walk_out[-1])) for walk_out in os.walk(src_dir)
+    )
+
+
+def file_st_size(path: Path | str):
+    path = Path(path)
+    if path.is_symlink():
+        return 0
+    try:
+        return path.stat().st_size
+    except Exception:
+        return 0
+
+
+def convert_bytes(size_in_bytes) -> str:
+    """
+    将字节数转换为易读的单位（KB, MB, GB）
+    :param size_in_bytes: 字节数
+    :return: 转换后的易读大小
+    """
+    units = ['B', 'KB', 'MB', 'GB', 'TB']
+    index = 0
+    while size_in_bytes >= 1024 and index < len(units) - 1:
+        size_in_bytes /= 1024.0
+        index += 1
+    return f"{size_in_bytes:.2f} {units[index]}"
+
+
+def get_disk_usage_in_one_depth(path: str | Path) -> Iterable[Tuple[int, Path]]:
+    """
+    获取目标目录下的所有文件和子目录（深度为1）的大小
+    :param path:
+    :return:
+    """
+    path = Path(path)
+    num_tasks = sum(1 for _ in os.scandir(path))
+    if not num_tasks:
+        yield 0, path
+        return
+    workers = min(4, num_tasks)
+    pipeline = (
+            task(path.iterdir, branch=True) |
+            task(total_st_size, workers=workers)
+    )
+    total_size = 0
+    for size, sub_path in pipeline():
+        total_size += size
+        if not path.is_absolute() and not str(path).startswith('.'):
+            sub_path = osp.join('.', sub_path)
+        yield size, sub_path
+    disk_usage_cache[osp.abspath(path)] = [total_size, osp.getmtime(path)]
+    yield total_size, path
+
+
+def get_disk_usage_all(path: str | Path) -> Iterable[Tuple[int, str]]:
+    """
+    获取当前文件或目录及其所有子目录或者文件大小
+    :param path:
+    :return:
+    """
+    pipeline = (
+            task(os.walk, branch=True) |
+            task(_walk_step, workers=4)
+    )
+    for out in pipeline(path, topdown=False):
+        yield from out
+
+
+def _walk_step(args):
+    root, dirs, files = args
+    root_st_size = 0
+    for file in files:
+        file_path = osp.join(root, file)
+        file_size = file_st_size(str(file_path))
+        root_st_size += file_size
+        yield file_size, file_path
+    for _dir in dirs:
+        dir_path = osp.join(root, _dir)
+        dir_st_size = total_st_size(str(dir_path))[0]
+        root_st_size += dir_st_size
+    disk_usage_cache[osp.abspath(root)] = [root_st_size, osp.getmtime(root)]
+    yield root_st_size, root
+
+
+def format_show_info_rich(size: int, path: str | Path) -> Text:
+    """
+    格式化显示信息,rich库
+    :param size:
+    :param path:
+    :return:
+    """
+    format_size = convert_bytes(size)
+    map_color = {
+        'B': 'white',
+        'KB': 'white',
+        'MB': 'green',
+        'GB': 'yellow',
+        'TB': 'red',
+    }
+    text = Text(f"{format_size:<10}{' ' * 10}{path}", style=map_color[format_size.split()[1]])
+    return text
+
+
+def update_disk_usage_cache_file(disk_usage_cache_file_path: str | Path, cache: dict):
+    Path(disk_usage_cache_file_path).parent.mkdir(parents=True, exist_ok=True)
+    with open(disk_usage_cache_file_path, 'w', encoding='utf-8') as f:
+        json.dump(cache, f, indent=4, ensure_ascii=False)
+
+
+def show_disk_usage(path: str, recursive: bool = False):
+    """
+    获取当前文件或目录及其所有子目录或者文件大小
+    :param path:
+    :param recursive: 是否递归查询子目录
+    :return:
+    """
+    path = Path(path.removesuffix('"'))
+    if not path.exists():
+        raise FileNotFoundError(f"{path} does not exist")
+    if path.is_file():
+        print(format_show_info_rich(file_st_size(path), path))
+        return
+    global disk_usage_cache
+    disk_usage_cache_file_path = get_disk_usage_cache_file(path)
+    disk_usage_cache = get_disk_usage_cache(disk_usage_cache_file_path)
+    if not recursive:
+        results = get_disk_usage_in_one_depth(path)
+    else:
+        results = get_disk_usage_all(path)
+    process = Progress(*Progress.get_default_columns(), TimeElapsedColumn())
+    pb = process.add_task(description="[green]正在统计文件及目录...", total=None)
+    process.start()
+    for sub_size, sub_path in results:
+        if not osp.isabs(sub_path) and not str(sub_path).startswith('.'):
+            sub_path = osp.join('.', sub_path)
+        print(format_show_info_rich(sub_size, sub_path))
+    process.update(pb, description='[purple]已统计完成！', )
+    process.stop()
+    update_disk_usage_cache_file(disk_usage_cache_file_path, disk_usage_cache)
+
+
+def get_disk_usage_cache_file(path: str | Path) -> Path:
+    path = osp.abspath(path)
+    if platform.system() == 'Windows':
+        disk_usage_cache_file_path = cache_dir / f'{osp.splitdrive(path)[0].strip(":")}.json'
+    else:
+        disk_usage_cache_file_path = cache_dir / f'{path.split("/")[1]}.json'
+    return disk_usage_cache_file_path
+
+
+def get_disk_usage_cache(disk_usage_cache_file_path: str | Path) -> dict:
+    if not osp.exists(disk_usage_cache_file_path):
+        return {}
+    try:
+        with open(disk_usage_cache_file_path, 'r', encoding='utf-8') as f:
+            return json.load(f)
+    except Exception as e:
+        print(f"[yellow]警告：无法读取缓存文件 {disk_usage_cache_file_path}，错误：{e}")
+        return {}
+
+
+def clear_unused_cache(path):
+    global disk_usage_cache
+    disk_usage_cache_file_path = get_disk_usage_cache_file(path)
+    disk_usage_cache = get_disk_usage_cache(disk_usage_cache_file_path)
+    if not disk_usage_cache:
+        print("[yellow]未发现缓存！")
+        return
+    new_cache = deepcopy(disk_usage_cache)
+    progress = Progress(*Progress.get_default_columns(), MofNCompleteColumn(), TimeElapsedColumn())
+    pb = progress.add_task(description="[green]正在清除无效缓存...", total=len(disk_usage_cache))
+    progress.start()
+    pipeline = (
+            task(disk_usage_cache.keys, branch=True) |
+            task(lambda key: (key, osp.exists(key)), workers=os.cpu_count())
+    )
+    for cache_key, is_valid in pipeline():
+        if not is_valid:
+            del new_cache[cache_key]
+            print(f"[green]已清除无效缓存：{cache_key}")
+        progress.advance(pb)
+    update_disk_usage_cache_file(disk_usage_cache_file_path, new_cache)
+    progress.update(pb, description='[purple]已清除完成！')
+    progress.stop()
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument('path', type=str, nargs='?', default='.', help='要查询的文件或目录路径')
+    parser.add_argument('-a', '--all', action='store_true', help='递归查询所有子目录')
+    parser.add_argument('-c', '--clear-cache', action='store_true', help='清除无效缓存')
+    args = parser.parse_args()
+    if args.clear_cache:
+        clear_unused_cache(args.path)
+
+    else:
+        show_disk_usage(args.path, args.all)
+
+
+if __name__ == '__main__':
+    main()

xstt-2026.4.23/fast_cp.py

@@ -0,0 +1,176 @@
+# @Time: 2025/5/9 上午10:17
+# @Autor: XS
+# @File: fast_cp.py
+# @Software: PyCharm
+
+"""
+/**
+ * _ooOoo_
+ * o8888888o
+ * 88" . "88
+ * (| -_- |)
+ *  O\ = /O
+ * ___/`---'\____
+ * .   ' \\| |// `.
+ * / \\||| : |||// \
+ * / _||||| -:- |||||- \
+ * | | \\\ - /// | |
+ * | \_| ''\---/'' | |
+ * \ .-\__ `-` ___/-. /
+ * ___`. .' /--.--\ `. . __
+ * ."" '< `.___\_<|>_/___.' >'"".
+ * | | : `- \`.;`\ _ /`;.`/ - ` : | |
+ * \ \ `-. \_ __\ /__ _/ .-` / /
+ * ======`-.____`-.___\_____/___.-`____.-'======
+ * `=---=' bug泛滥 佛已瘫痪
+"""
+import argparse
+import os
+import os.path as osp
+from shutil import copymode
+from pyper import task
+from pathlib import Path
+from rich.progress import Progress, TimeElapsedColumn, TransferSpeedColumn, DownloadColumn
+from rich import print
+
+COPY_BUFSIZE = 1024 * 1024 if os.name == 'nt' else 64 * 1024
+progress = Progress(*Progress.get_default_columns(), TransferSpeedColumn(), DownloadColumn(), TimeElapsedColumn())
+task_id = progress.add_task('[green]文件大小统计中...', total=None)
+
+
+# from typing import Iterable
+
+
+# def get_all_files(src: (str, MyPath)) -> Iterable[MyPath]:
+#     src = MyPath(src)
+#     if not src.exists():
+#         raise FileNotFoundError(f'{src}不存在')
+#     return filter(lambda file: file.is_file(), src.iter_dir(recursive=True))
+
+
+def is_file_in_snapshot(file: Path, snapshot_time: float):
+    try:
+        return file.stat().st_mtime <= snapshot_time
+    except Exception:
+        return False
+
+
+def _copy(src: str | Path, dst: str | Path) -> str:
+    src, dst = Path(src), Path(dst)
+    if dst.is_dir():
+        dst = dst / src.name
+    dst.parent.mkdir(parents=True, exist_ok=True)
+    if the_same_file_exists(src, dst):
+        progress.advance(task_id, src.stat().st_size)
+        return f'[yellow]{src}已存在，直接跳过！[/yellow]'
+    with open(src, 'rb') as src_file:
+        with open(dst, 'wb') as dst_file:
+            while True:
+                data = src_file.read(COPY_BUFSIZE)
+                if not data:
+                    break
+                dst_file.write(data)
+                progress.advance(task_id, len(data))
+    copymode(src, dst)
+    return dst.as_posix()
+
+
+def _copy_file(file_path: Path, src_dir: str, dst_dir: str) -> str:
+    dst_path = Path(str(file_path).replace(src_dir, dst_dir))
+    dst_path.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        return _copy(file_path, dst_path)
+    except Exception as e:
+        return f'[red]{file_path}拷贝失败，错误信息为：{e}'
+
+
+def the_same_file_exists(src_file: str | Path, dst_file: str | Path) -> bool:
+    src_file, dst_file = Path(src_file), Path(dst_file)
+    return dst_file.exists() and src_file.stat().st_size == dst_file.stat().st_size
+
+
+def fast_copy(src: str, dst: str, workers: int = 20, verbose: bool = False) -> None:
+    src, dst = Path(src).absolute(), Path(dst).absolute()
+    if not src.exists():
+        raise FileNotFoundError(f'{src}不存在!')
+
+    progress.start()
+    desc = f'[green]{src} [yellow]--->[/yellow] {dst}'
+    if dst.is_dir() and src.name != dst.name:
+        dst = dst / src.name
+    if src.is_file():
+        total = src.stat().st_size
+        progress.update(task_id, total=total, description=desc)
+        out = _copy(src, dst)
+        verbose and print(out)
+
+    else:
+        dst.parent.mkdir(parents=True, exist_ok=True)
+        total = get_dir_total_size_parallel(src)
+        # snapshot_time = time.time()
+        # total = sum(
+        #     sum(map(lambda file: osp.getsize(osp.join(walk_out[0], file)), walk_out[-1])) for walk_out in os.walk(src)
+        # )
+        progress.update(task_id, total=total, description=desc)
+        pipeline = (
+                task(lambda path: (file for file in path.rglob('*') if file.is_file()), branch=True) |
+                task(_copy_file, bind=task.bind(src_dir=str(src), dst_dir=str(dst)), workers=workers)
+        )
+
+        for out in pipeline(src):
+            out = str(out)
+            verbose and print(out)
+            '错误' in out and print(out)
+    progress.update(task_id, completed=total)
+    progress.stop()
+    print(f'[green]拷贝完成！[/green]'.center(100, '*'))
+
+
+def get_file_size(src_file: str | Path) -> int:
+    try:
+        file_size = osp.getsize(src_file)
+    except Exception as e:
+        # print(f'[yellow]{src_file} 获取文件大小失败，错误信息为：{e}')
+        file_size = 0
+    return file_size
+
+
+def get_dir_total_size(src_dir):
+    return sum(
+        sum(map(lambda file: get_file_size(str(osp.join(walk_out[0], file))), walk_out[-1])) for walk_out in
+        os.walk(src_dir)
+    )
+
+
+def get_dir_total_size_parallel(src: str | Path) -> int:
+    """
+    获取目录下所有文件的大小总和，一级子目录并行进行统计
+    :param src:
+    :return:
+    """
+    src = Path(src)
+    total_num = sum(get_file_size(file) for file in src.iterdir() if file.is_file())
+    workers = min(4, sum(1 for file in os.scandir(src) if file.is_dir()))
+    if workers == 0:
+        return total_num
+    pipeline = (
+            task(lambda path: (file for file in path.iterdir() if file.is_dir()), branch=True) |
+            task(get_dir_total_size, workers=workers, multiprocess=True)
+    )
+    for num in pipeline(src):
+        total_num += num
+    return total_num
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument('src', type=str, help='源路径')
+    parser.add_argument('dst', type=str, help='目标路径')
+    parser.add_argument('-t', '--threads', type=int, default=4, help='线程数，默认值为2倍cpu核心数')
+    parser.add_argument('-v', '--verbose', action='store_true', help='显示详细拷贝信息')
+    args = parser.parse_args()
+    fast_copy(args.src, args.dst, args.threads, args.verbose)
+
+
+if __name__ == '__main__':
+    main()

xstt-2026.4.23/ls.py

@@ -0,0 +1,167 @@
+"""
+Author: xiash$
+Date: 2025/5/16$
+Project: terminal_tools$
+Description: $
+***
+* _ooOoo_
+* o8888888o
+* 88" . "88
+* (| -_- |)
+*  O\ = /O
+* ___/`---'\____
+* .   ' \\| |// `.
+* / \\||| : |||// \
+* / _||||| -:- |||||- \
+* | | \\\ - /// | |
+* | \_| ''\---/'' | |
+* \ .-\__ `-` ___/-. /
+* ___`. .' /--.--\ `. . __
+* ."" '< `.___\_<|>_/___.' >'"".
+* | | : `- \`.;`\ _ /`;.`/ - ` : | |
+* \ \ `-. \_ __\ /__ _/ .-` / /
+* ======`-.____`-.___\_____/___.-`____.-'======
+* `=---='
+*          .............................................
+*           佛曰：bug泛滥，我已瘫痪！
+"""
+import argparse
+import os
+
+from rich.console import Console
+from rich.table import Table
+from rich.panel import Panel
+from rich.tree import Tree
+from datetime import datetime
+from pathlib import Path
+from disk_usage import convert_bytes
+
+console = Console()
+executable_extensions = {".exe", ".bat", ".cmd", ".ps1", ".msi", ".com", '.vbs'}
+archive_files = ['.zip', '.rar', '.tar.gz', '.tar.bz2', '.7z', '.tar', '.gz', '.gzip', '.bz2', '.xz', '.iso',
+                 '.cab', 'jar', '.war', '.ear']
+
+
+def get_permissions(path: str | Path) -> str:
+    path = Path(path)
+    mode = path.lstat().st_mode  # 获取权限位
+    perm_list = []
+    map_who = {
+        '所有者': mode >> 6 & 0o7,
+        '组': mode >> 3 & 0o7,
+        '其他': mode & 0o7
+    }
+    # 解析权限
+    for name, who in map_who.items():
+        temp = []
+        if who & 0o4:
+            temp.append('读')
+        if who & 0o2:
+            temp.append('写')
+        if who & 0o1:
+            temp.append('执行')
+        perm_list.append(f"{name}: {','.join(temp)}")
+
+    return '\n'.join(perm_list)
+
+
+def list_directory():
+    """
+    列出目录下的所有文件及子目录信息(类似ls命令)
+    """
+    args = parse_args()
+    target_dir = args.target_dir
+    target_dir = Path(target_dir)
+    abs_path = str(target_dir.resolve())
+    icon_map = {
+        '文件': '📄',
+        '目录': '📁',
+        '符号链接': '🔗',
+        '归档文件(压缩包)': '📦',
+        '可执行文件': '💻',
+        'python脚本': '🐍',
+    }
+    tree = Tree(
+        f"{icon_map['目录']} [cyan]{abs_path}",
+        guide_style="bold",
+    )
+
+    for file in target_dir.iterdir():
+        if file.is_symlink():
+            tree.add(f'{icon_map["符号链接"]} [yellow]{file.name}')
+        elif file.is_dir():
+            tree.add(f'{icon_map["目录"]} [cyan]{file.name}')
+        elif file.suffix in archive_files:
+            tree.add(f'{icon_map["归档文件(压缩包)"]} [red]{file.name}')
+        elif file.suffix == '.py':
+            tree.add(f'{icon_map["python脚本"]} [green]{file.name}')
+        elif is_executable(file):
+            tree.add(f'{icon_map["可执行文件"]} [green]{file.name}')
+        else:
+            tree.add(f'{icon_map["文件"]} [white]{file.name}')
+    console.print(Panel(tree, expand=False))
+
+
+def is_executable(path: Path) -> bool:
+    path = Path(path)
+    if os.name == 'nt':
+        return path.suffix in executable_extensions
+    return path.is_file() and os.access(path, os.X_OK)
+
+
+def long_list():
+    """
+    列出目录下的所有文件及子目录信息(类似ll命令)
+    """
+    args = parse_args()
+    target_dir = args.target_dir
+
+    target_dir = Path(target_dir)
+
+    table_title = f"目录 '{target_dir.resolve()}' 的内容"
+    table = Table(title=f"[bold cyan]{table_title}[/bold cyan]", show_lines=True)
+    table.add_column("名称", justify='center', vertical='middle', no_wrap=True)
+    table.add_column("类型", justify='center', vertical='middle')
+    table.add_column("权限", justify='center', vertical='middle')
+    table.add_column("大小", justify='center', vertical='middle')
+    table.add_column("最后修改时间", justify='center', vertical='middle')
+    for file in target_dir.iterdir():
+        item_stat = file.stat()
+        file_st_size = convert_bytes(item_stat.st_size)
+        file_name = file.name
+        if file.is_symlink():
+            file_st_size = '-'
+            txt_color = 'yellow'
+            item_type = "符号链接"
+            file_name = f'{file}(-> {file.readlink()})'
+        elif file.is_dir():
+            file_st_size = '-'
+            txt_color = 'cyan'
+            item_type = '目录'
+        elif file.is_file() and file.suffix in archive_files:
+            txt_color = 'red'
+            item_type = '归档文件(压缩包)'
+        elif is_executable(file):
+            txt_color = 'green'
+            item_type = '可执行文件'
+        else:
+            txt_color = 'white'
+            item_type = '文件'
+
+        mtime_timestamp = item_stat.st_mtime
+        mtime_str = datetime.fromtimestamp(mtime_timestamp).strftime('%Y-%m-%d %H:%M:%S')
+        item_permissions = get_permissions(file)
+        table.add_row(f"[bold {txt_color}]{file_name}", f'[{txt_color}]{item_type}', f'[{txt_color}]{item_permissions}',
+                      f'[{txt_color}]{file_st_size}', f'[{txt_color}]{mtime_str}')
+    console.print(table)
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(description='列出目录下的所有文件及子目录信息')
+    parser.add_argument('target_dir', type=str, nargs='?', default='.', help='目标目录')
+    args = parser.parse_args()
+    return args
+
+
+if __name__ == '__main__':
+    list_directory()

xstt-2026.4.23/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xstt"
+version = "2026.04.23"
+description = "一些终端实用命令行工具"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "python-pyper",
+    "rich",
+    "typer-slim[standard]",
+    'rapidfuzz',
+    'pypinyin'
+]
+
+[project.scripts]
+wcp = "fast_cp:main"
+wdu = "disk_usage:main"
+wll = "ls:long_list"
+wls = "ls:list_directory"
+wrm = "rm:main"
+sq = "book_mark:main"
+
+[tool.setuptools]
+py-modules = ["fast_cp", "disk_usage", 'ls', 'rm', 'book_mark']
+
+[tool.pixi.workspace]
+channels = ["conda-forge"]
+platforms = ["win-64", 'linux-64']
+
+[tool.pixi.pypi-dependencies]
+ttxs = { path = ".", editable = true }
+
+[tool.pixi.dependencies]
+python = "3.10.*"

xstt-2026.4.23/rm.py

@@ -0,0 +1,131 @@
+"""
+Author: xiash$
+Date: 2025/5/17$
+Project: terminal_tools$
+Description: $
+***
+* _ooOoo_
+* o8888888o
+* 88" . "88
+* (| -_- |)
+*  O\ = /O
+* ___/`---'\____
+* .   ' \\| |// `.
+* / \\||| : |||// \
+* / _||||| -:- |||||- \
+* | | \\\ - /// | |
+* | \_| ''\---/'' | |
+* \ .-\__ `-` ___/-. /
+* ___`. .' /--.--\ `. . __
+* ."" '< `.___\_<|>_/___.' >'"".
+* | | : `- \`.;`\ _ /`;.`/ - ` : | |
+* \ \ `-. \_ __\ /__ _/ .-` / /
+* ======`-.____`-.___\_____/___.-`____.-'======
+* `=---='
+*          .............................................
+*           佛曰：bug泛滥，我已瘫痪！
+"""
+import argparse
+import shutil
+import os
+import stat
+
+from rich.progress import Progress, TimeElapsedColumn
+from rich import print
+from pyper import task
+from pathlib import Path
+
+progress = Progress(
+    *Progress.get_default_columns(),
+    TimeElapsedColumn(),
+)
+
+
+def remove_force(path: Path | str):
+    """
+    删除某个文件或整个目录
+    """
+    path = Path(path)
+    if path.is_file() or path.is_symlink():
+        try:
+            path.unlink()
+        except PermissionError:
+            os.chmod(path, stat.S_IWRITE)
+            try:
+                path.unlink()
+            except Exception as e:
+                print(f'注意：[yellow]{e}')
+    else:
+        try:
+            shutil.rmtree(path, onerror=remove_readonly)
+        except Exception as e:
+            print(f'注意：[yellow]{e}')
+
+
+def fast_rm(path: Path | str, workers: int = 4):
+    """
+    快速删除文件或整个目录
+    """
+    path = Path(path)
+    progress_bar = progress.add_task('[green]删除中...', total=None)
+    progress.start()
+    final_desc = f'[purple]{path} 删除完成！'
+    if path.is_file() or path.is_symlink():
+        remove_force(path)
+        progress.update(progress_bar, total=1, advance=1, description=final_desc)
+    else:
+        total = len(os.listdir(path))
+        progress.update(progress_bar, total=total + 1)
+        if total > 0:
+            workers = min(total, workers)
+            pipeline = (
+                    task(path.iterdir, branch=True) |
+                    task(remove_force, workers=workers)
+            )
+            for _ in pipeline():
+                progress.advance(progress_bar)
+        shutil.rmtree(path, onerror=remove_readonly)
+        progress.update(progress_bar, advance=1, description=final_desc)
+
+
+def remove_readonly(func, path, exc_info):
+    """
+    用于处理权限问题
+    """
+    try:
+        os.chmod(path, stat.S_IWRITE)
+        func(path)
+    except Exception as e:
+        print(f'注意：[yellow]{e}')
+
+
+def gather_paths(paths: list):
+    """
+    将路径列表中的路径进行展开，并返回一个列表
+    """
+    for path in paths:
+        path = Path(path)
+        yield path
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument('path', nargs='+', type=str, help='要删除的文件或目录路径')
+    parser.add_argument('-t', '--threads', type=int, default=4, help='删除文件时并发线程数')
+    args = parser.parse_args()
+    num_paths = len(args.path)
+    if num_paths == 0:
+        print('[red]没有要删除的文件或目录！')
+    else:
+        workers = min(num_paths, os.cpu_count() * 2)
+        pipeline = (
+                task(gather_paths, branch=True) |
+                task(fast_rm, workers=workers)
+        )
+        for _ in pipeline(args.path):
+            pass
+    progress.stop()
+
+
+if __name__ == '__main__':
+    main()

xstt-2026.4.23/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xstt-2026.4.23/xstt.egg-info/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: xstt
+Version: 2026.4.23
+Summary: 一些终端实用命令行工具
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: python-pyper
+Requires-Dist: rich
+Requires-Dist: typer-slim[standard]
+Requires-Dist: rapidfuzz
+Requires-Dist: pypinyin

xstt-2026.4.23/xstt.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+book_mark.py
+disk_usage.py
+fast_cp.py
+ls.py
+pyproject.toml
+rm.py
+xstt.egg-info/PKG-INFO
+xstt.egg-info/SOURCES.txt
+xstt.egg-info/dependency_links.txt
+xstt.egg-info/entry_points.txt
+xstt.egg-info/requires.txt
+xstt.egg-info/top_level.txt

xstt-2026.4.23/xstt.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

xstt-2026.4.23/xstt.egg-info/entry_points.txt

@@ -0,0 +1,7 @@
+[console_scripts]
+sq = book_mark:main
+wcp = fast_cp:main
+wdu = disk_usage:main
+wll = ls:long_list
+wls = ls:list_directory
+wrm = rm:main

xstt-2026.4.23/xstt.egg-info/requires.txt

@@ -0,0 +1,5 @@
+python-pyper
+rich
+typer-slim[standard]
+rapidfuzz
+pypinyin

xstt-2026.4.23/xstt.egg-info/top_level.txt

@@ -0,0 +1,5 @@
+book_mark
+disk_usage
+fast_cp
+ls
+rm