ypp 0.3.5

多分支 worktree 管理工具

ypp

多分支 worktree 管理工具（支持 krepo-ng 与 git）。

安装

pip install ypp

使用

• 创建 worktree：

ypp add <path> <branch>

这会在 ~/<path>/wpsmain 和 ~/<path>/wpsweb 下分别创建或切换到 <branch>。

• 列出 worktree：

ypp list

• 移除 worktree：

ypp remove <path>

这会移除 ~/<path>/wpsmain 和 ~/<path>/wpsweb 的 worktree，并删除整个 <path> 目录。

• 配置管理：

ypp set work_dir=~/workspace  # 设置工作目录
ypp config                    # 显示当前配置

• 修改配置和生成构建脚本（仅限 Linux）：

ypp modify                    # 修改 wpsweb/server/Makefile 和生成 build_server.sh
ypp modify --force            # 强制在非 Linux 系统上运行（不推荐）

这会自动查找 wpsweb 目录，并执行以下操作：

1. 修改 server/Makefile：
   • 去掉 -Wl,-s 参数
   • 将 -O2 修改为 -g
2. 生成 build_server.sh：
   • 清空文件内容并写入构建脚本
   • 动态替换路径变量（基于当前执行路径）
   • 自动设置执行权限

注意: modify 命令仅在 Linux 系统上支持，因为它需要修改 Makefile 和生成 shell 脚本。

• 初始化仓库：

ypp init wpsmain             # 初始化 wpsmain 仓库
ypp init wpsweb              # 初始化 wpsweb 仓库
ypp init                     # 依次初始化 wpsmain 和 wpsweb 仓库

这会执行以下操作：

1. wpsmain 初始化：在当前目录执行 krepo-ng init -b master_kso_v12 --bundle all
2. wpsweb 初始化：在当前目录执行 git clone [e-mail]:wow/wpsweb.git

• 自动编译 wpsmain：

ypp build                     # 自动编译 wpsmain

这会自动查找 wpsmain 目录，并在 Docker 中执行以下操作：

1. 配置 weboffice：执行 krepo-ng config --new -x weboffice
2. 检查目录：验证 debug_weboffice 目录是否创建成功
3. 编译项目：在 debug_weboffice 目录中执行 krepo-ng build
4. 执行构建脚本：查找并执行 wpsweb/build_server.sh 脚本

注意: build 命令需要在 Docker 环境中执行，使用 kdocker -r qt5 命令。

• 读取和清除 PPTX 文件属性：

ypp pptattr <filepath>                    # 读取 PPTX 文件属性
ypp pptattr <filepath> --clean           # 清除指定属性并保存到原文件

这会执行以下操作：

1. 读取属性：显示 PPTX 文件的核心属性、应用属性和自定义属性
2. 清除属性（使用 --clean 参数时）：
   • 清除核心属性中的 lastModifiedBy
   • 清除自定义属性中的 ICV
   • 保持原有的 XML 结构，确保与 Office 应用程序兼容
   • 自动保存到原文件

注意: pptattr 命令只支持 .pptx 格式的文件。使用 --clean 参数会直接修改原文件，建议先备份。

• WSL 端口转发管理：

ypp wsl port <本机端口> <WSL端口>        # 添加端口转发
ypp wsl port remove <本机端口>           # 移除端口转发
ypp wsl port list                       # 列出所有端口转发规则

这会执行以下操作：

1. 添加端口转发：将本机的指定端口转发到 WSL 中的指定端口
2. 移除端口转发：删除指定的端口转发规则
3. 列出规则：显示当前所有的端口转发规则

注意: wsl port 命令仅在 Windows 系统上支持。添加和移除端口转发需要管理员权限，系统会自动弹出 UAC 对话框请求权限。查看端口转发规则不需要管理员权限。

依赖

• 需要本机已安装并在 PATH 中可用：krepo-ng、git。
• 配置文件位置：~/.ypp.json

许可

MIT