mcpywrap 0.2.3__tar.gz → 0.3.1__tar.gz

mcpywrap-0.3.1/CHANGELOG.md

@@ -0,0 +1,25 @@
+# 更新记录
+
+## 0.3.1
+
+- 完善游戏引擎自动发现：优先检查当前用户注册表的两个视图，失败后搜索固定磁盘中的标准下载目录。
+- 仅选择包含游戏 EXE 的有效版本目录，跳过残缺安装和杂项目录，按语义版本稳定排序。
+- 支持通过项目配置、环境变量和 CLI 指定游戏 EXE、下载目录及引擎版本；无效覆盖和版本冲突明确报错。
+- 新增只读 `mcpy doctor` 和 JSON 诊断，分别报告游戏、编辑器及 Safaia 的资源状态。
+- CLI 与 GUI 共用发现结果，运行配置和实际 EXE 保持一致；已有实例默认保留原版本，不再自动切换到最新版。
+- 新增 27 项隔离测试，完整回归共 60 项通过；本机只读验证选中 MCS 引擎 3.10.0.420447。
+- 精简 README 为上手指引，将依赖、引擎配置和开发验证细节整理为独立文档。
+
+## 0.3.0
+
+- 新增本地 Addon 目录依赖：CLI、初始化向导和 GUI 支持直接添加、预检和移除目录引用，无需初始化或安装被引用项目。
+- Python 包和本地目录共用依赖图，支持相对路径、真实路径去重、循环检测及标准 requirement 版本和环境标记校验。
+- `build/run/edit/dev` 接入本地依赖；运行前重新校验，避免缓存过期的依赖集合。
+- **构建行为变更**：主项目优先，完整与增量构建统一依赖顺序；删除高优先级文件后恢复低优先级来源。
+- 构建前拒绝输出与源目录重叠；无效依赖不清空已有输出。
+- Windows 链接保留其他项目内容，支持无符号链接权限时使用目录 junction；游戏启动使用实际进程句柄。
+- 修正最低 Python 版本为 3.9，与现有运行代码要求一致。
+- 显式依赖 pip，确保通过 uv 安装的隔离工具环境也能执行 Python 包的添加和初始化安装。
+- 新增自动化测试、打包校验和 GitHub Actions → PyPI Trusted Publishing 流程。
+
+本机已通过 33 项自动化测试及 MCS 3.10.0.420447 的四组实际游戏加载测试。

mcpywrap-0.3.1/MANIFEST.in

@@ -0,0 +1,7 @@
+include LICENSE README.md CHANGELOG.md
+include docs/releasing.md
+include docs/local-dependencies.md docs/engine-discovery.md docs/development.md
+recursive-include tests *.py
+prune test
+prune .git
+global-exclude __pycache__ *.py[cod] *.cppconfig *.log

mcpywrap-0.3.1/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: mcpywrap
+Version: 0.3.1
+Summary: A wrapper for Minecraft China Edition Addons management
+Author-email: boybook <boybook@easecation.net>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/EaseCation/mcpywrap
+Project-URL: Bug Tracker, https://github.com/EaseCation/mcpywrap/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pip>=21
+Requires-Dist: click>=8.0.0
+Requires-Dist: watchdog>=2.0.0
+Requires-Dist: twine>=3.4.0
+Requires-Dist: tomli
+Requires-Dist: tomli-w
+Requires-Dist: setuptools
+Requires-Dist: packaging>=21
+Requires-Dist: PyQt5>=5.15.0
+Requires-Dist: psutil>=5.8.0
+Requires-Dist: rich>=10.0.0
+Dynamic: license-file
+
+# mcpywrap
+
+**用 Python 标准项目与依赖管理方式开发《我的世界》中国版 Mod 和资源包。**
+
+[![PyPI Version](https://img.shields.io/pypi/v/mcpywrap)](https://pypi.org/project/mcpywrap/)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+mcpywrap 使用 `pyproject.toml` 管理项目，支持安装 Python 包依赖，也支持直接引用本地 Addon 目录。它将依赖管理、资源构建、游戏运行和 MC Studio 编辑器串成一套开发流程，方便多个项目共享代码与资源。
+
+## 安装
+
+需要 Python 3.9 或更高版本。游戏和编辑器启动功能需要 Windows、MC Studio 及已下载的游戏引擎。
+
+推荐通过 [uv](https://docs.astral.sh/uv/) 安装：
+
+```powershell
+uv tool install mcpywrap
+```
+
+也可以使用 `pip install mcpywrap`。安装完成后，运行 `mcpy --help` 查看命令。
+
+## 开始使用
+
+进入你的 Addon 或地图项目目录，按向导初始化：
+
+```powershell
+mcpy init
+```
+
+之后可以直接运行游戏测试，或在 MC Studio 编辑器中打开项目：
+
+```powershell
+mcpy run
+mcpy edit
+```
+
+需要查看项目和管理依赖时，运行 `mcpy ui` 打开图形界面。
+
+## 复用代码和资源
+
+对于已发布的 Python 包，使用包名添加依赖：
+
+```powershell
+mcpy add "package-name>=1.0"
+```
+
+对于本机已有的 Addon，直接引用它的目录：
+
+```powershell
+mcpy add --path "../shared-addon"
+```
+
+本地 Addon 无需先初始化或安装，可以直接使用 MCS 导出的目录。请选择包含行为包或资源包的 Addon 根目录；相对路径以当前项目目录为基准。
+
+移除依赖使用 `mcpy remove <包名>` 或 `mcpy remove --path <目录>`。移除本地引用不会删除源目录。不带参数运行 `mcpy add` / `mcpy remove` 可进入选择向导。
+
+本地路径适合同机开发；与他人共享项目时，需要同步这些目录，或将可复用组件发布为 Python 包。目录结构、配置及构建规则见[本地依赖参考](https://github.com/EaseCation/mcpywrap/blob/main/docs/local-dependencies.md)。
+
+## 构建与日常开发
+
+| 命令 | 用途 |
+|---|---|
+| `mcpy build` | 将项目和依赖构建到配置的输出目录 |
+| `mcpy dev` | 监控 Addon 源码与依赖变化，持续更新构建结果 |
+| `mcpy mod` | 通过向导创建 Python Mod 框架 |
+| `mcpy modsdk` | 管理网易 ModSDK |
+| `mcpy run -n` | 创建新的游戏测试实例 |
+| `mcpy run -l` | 查看已有实例 |
+| `mcpy run -d <ID前缀>` | 删除指定实例 |
+
+`mcpy run` 默认复用最近创建的实例。构建时主项目内容优先于依赖；修改依赖声明后，请重新启动 `mcpy dev`。
+
+## 游戏启动与排查
+
+通常不需要手动指定游戏路径。mcpywrap 会优先查找 MC Studio 登记的安装，必要时搜索固定磁盘中的标准下载目录，并跳过不完整的引擎版本。
+
+遇到找不到游戏或缺少资源的提示，先运行：
+
+```powershell
+mcpy doctor
+```
+
+需要使用特定版本时，可以临时指定：
+
+```powershell
+mcpy run --engine-version 3.10.0.420447
+```
+
+已有实例默认保留原引擎版本；显式指定版本可以切换。自定义路径、项目级设置和环境变量的用法见[引擎配置参考](https://github.com/EaseCation/mcpywrap/blob/main/docs/engine-discovery.md)。
+
+## 更多信息
+
+- 运行 `mcpy <命令> --help` 查看该命令的选项。
+- [更新记录](https://github.com/EaseCation/mcpywrap/blob/main/CHANGELOG.md)
+- [开发与验证](https://github.com/EaseCation/mcpywrap/blob/main/docs/development.md) · [发布流程](https://github.com/EaseCation/mcpywrap/blob/main/docs/releasing.md)
+- 欢迎通过 [Issues](https://github.com/EaseCation/mcpywrap/issues) 反馈问题或提交 PR。
+
+[MIT License](LICENSE) © EaseCation

mcpywrap-0.3.1/README.md

@@ -0,0 +1,98 @@
+# mcpywrap
+
+**用 Python 标准项目与依赖管理方式开发《我的世界》中国版 Mod 和资源包。**
+
+[![PyPI Version](https://img.shields.io/pypi/v/mcpywrap)](https://pypi.org/project/mcpywrap/)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+mcpywrap 使用 `pyproject.toml` 管理项目，支持安装 Python 包依赖，也支持直接引用本地 Addon 目录。它将依赖管理、资源构建、游戏运行和 MC Studio 编辑器串成一套开发流程，方便多个项目共享代码与资源。
+
+## 安装
+
+需要 Python 3.9 或更高版本。游戏和编辑器启动功能需要 Windows、MC Studio 及已下载的游戏引擎。
+
+推荐通过 [uv](https://docs.astral.sh/uv/) 安装：
+
+```powershell
+uv tool install mcpywrap
+```
+
+也可以使用 `pip install mcpywrap`。安装完成后，运行 `mcpy --help` 查看命令。
+
+## 开始使用
+
+进入你的 Addon 或地图项目目录，按向导初始化：
+
+```powershell
+mcpy init
+```
+
+之后可以直接运行游戏测试，或在 MC Studio 编辑器中打开项目：
+
+```powershell
+mcpy run
+mcpy edit
+```
+
+需要查看项目和管理依赖时，运行 `mcpy ui` 打开图形界面。
+
+## 复用代码和资源
+
+对于已发布的 Python 包，使用包名添加依赖：
+
+```powershell
+mcpy add "package-name>=1.0"
+```
+
+对于本机已有的 Addon，直接引用它的目录：
+
+```powershell
+mcpy add --path "../shared-addon"
+```
+
+本地 Addon 无需先初始化或安装，可以直接使用 MCS 导出的目录。请选择包含行为包或资源包的 Addon 根目录；相对路径以当前项目目录为基准。
+
+移除依赖使用 `mcpy remove <包名>` 或 `mcpy remove --path <目录>`。移除本地引用不会删除源目录。不带参数运行 `mcpy add` / `mcpy remove` 可进入选择向导。
+
+本地路径适合同机开发；与他人共享项目时，需要同步这些目录，或将可复用组件发布为 Python 包。目录结构、配置及构建规则见[本地依赖参考](https://github.com/EaseCation/mcpywrap/blob/main/docs/local-dependencies.md)。
+
+## 构建与日常开发
+
+| 命令 | 用途 |
+|---|---|
+| `mcpy build` | 将项目和依赖构建到配置的输出目录 |
+| `mcpy dev` | 监控 Addon 源码与依赖变化，持续更新构建结果 |
+| `mcpy mod` | 通过向导创建 Python Mod 框架 |
+| `mcpy modsdk` | 管理网易 ModSDK |
+| `mcpy run -n` | 创建新的游戏测试实例 |
+| `mcpy run -l` | 查看已有实例 |
+| `mcpy run -d <ID前缀>` | 删除指定实例 |
+
+`mcpy run` 默认复用最近创建的实例。构建时主项目内容优先于依赖；修改依赖声明后，请重新启动 `mcpy dev`。
+
+## 游戏启动与排查
+
+通常不需要手动指定游戏路径。mcpywrap 会优先查找 MC Studio 登记的安装，必要时搜索固定磁盘中的标准下载目录，并跳过不完整的引擎版本。
+
+遇到找不到游戏或缺少资源的提示，先运行：
+
+```powershell
+mcpy doctor
+```
+
+需要使用特定版本时，可以临时指定：
+
+```powershell
+mcpy run --engine-version 3.10.0.420447
+```
+
+已有实例默认保留原引擎版本；显式指定版本可以切换。自定义路径、项目级设置和环境变量的用法见[引擎配置参考](https://github.com/EaseCation/mcpywrap/blob/main/docs/engine-discovery.md)。
+
+## 更多信息
+
+- 运行 `mcpy <命令> --help` 查看该命令的选项。
+- [更新记录](https://github.com/EaseCation/mcpywrap/blob/main/CHANGELOG.md)
+- [开发与验证](https://github.com/EaseCation/mcpywrap/blob/main/docs/development.md) · [发布流程](https://github.com/EaseCation/mcpywrap/blob/main/docs/releasing.md)
+- 欢迎通过 [Issues](https://github.com/EaseCation/mcpywrap/issues) 反馈问题或提交 PR。
+
+[MIT License](LICENSE) © EaseCation

mcpywrap-0.3.1/docs/development.md

@@ -0,0 +1,15 @@
+# 开发与验证
+
+```powershell
+python -m unittest discover -s tests -v
+```
+
+自动化测试使用临时目录、Click、Qt 离屏及安装／启动替身。本机多项目验收脚本另行执行真实 CLI、pip、watchdog，可加 `--game` 启动已安装的 MCS 引擎。请先关闭已有游戏，使用独立环境和一个尚不存在的输出目录：
+
+```powershell
+uv venv test/acceptance-venv
+uv pip install --python test/acceptance-venv/Scripts/python.exe -e . pip
+test/acceptance-venv/Scripts/python.exe tests/manual_integration.py --workspace test/my-acceptance --game
+```
+
+脚本保留测试项目、构建结果、CLI/pip 日志和 `report.json`；实际游戏验证检查各 Mod 的服务端／客户端加载标记及游戏生成的包 UUID 列表，并清理本次创建的全局链接。测试存档和 `.runtime` 配置保留供复查。游戏验收仅替换日志窗口为 TCP 文件收集器，真实引擎、目录链接和运行配置均使用产品实现。

mcpywrap-0.3.1/docs/engine-discovery.md

@@ -0,0 +1,72 @@
+# 游戏引擎发现与诊断
+
+`mcpy run` 和 `mcpy edit` 共用引擎发现机制，图形界面使用同样的项目配置和环境变量。
+默认先读取当前用户 MC Studio 注册表的两个视图，选择该安装中最新的完整引擎。
+注册表安装无法满足要求时，再检查各固定磁盘根目录的
+`MCStudioDownload/game/MinecraftPE_Netease`，合并候选后按版本选择。
+不会读取运行进程、访问网络盘或递归扫描全盘，也不会自动保存发现的机器路径。
+
+只有版本目录名有效且包含 `Minecraft.Windows.exe` 普通文件的目录才会入选。
+例如 `3.10` 高于 `3.9`；临时目录、备份目录及未下载完成的版本会被跳过。
+同版本按绝对路径排序，结果稳定；每次操作重新发现，操作内复用同一个结果。
+
+先运行只读诊断，无需初始化 Mod 项目：
+
+```powershell
+mcpy doctor
+mcpy doctor --json
+mcpy doctor --engine-version 3.10.0.420447
+```
+
+诊断会显示候选与选中路径、注册表或磁盘来源、跳过原因，以及运行、编辑器、
+Safaia 分别缺少的资源。JSON 包含 `candidates`、`selected`、`diagnostics`、
+`error`、`resources` 和 `ok`。游戏发现或运行资源检查失败返回退出码 1；
+编辑器、Safaia 缺失单独报告，不影响仅运行游戏的就绪状态。
+
+### 固定路径和版本
+
+以下字段均可选，可加入 Mod 项目的 `pyproject.toml`：
+
+```toml
+[tool.mcpywrap]
+game_executable_path = 'D:\MCStudioDownload\game\MinecraftPE_Netease\3.10.0.420447\Minecraft.Windows.exe'
+mcs_download_path = 'D:\MCStudioDownload'
+engine_version = '3.10.0.420447'
+```
+
+每个字段独立采用 **命令行 > 环境变量 > 项目配置** 的优先级。
+团队项目通常只提交 `engine_version`，本机路径可放在环境变量中：
+
+| 项目配置 | 环境变量 | 命令行选项 |
+|---|---|---|
+| `game_executable_path` | `MCPY_GAME_EXECUTABLE` | `--game-executable` |
+| `mcs_download_path` | `MCPY_MCS_DOWNLOAD_PATH` | `--mcs-download-path` |
+| `engine_version` | `MCPY_ENGINE_VERSION` | `--engine-version` |
+
+```powershell
+$env:MCPY_MCS_DOWNLOAD_PATH = 'D:\MCStudioDownload'
+mcpy run --engine-version 3.10.0.420447
+mcpy edit --mcs-download-path 'D:\MCStudioDownload'
+```
+
+三个选项均适用于 `run`、`edit` 和 `doctor`。项目中的相对路径以
+`pyproject.toml` 所在目录为基准；命令行与环境变量中的相对路径以调用目录为基准。
+不自动向上搜索项目。版本需要填写实际完整版本，`3.10` 不作为 `3.10.*` 通配符。
+
+显式路径无效、版本不存在或路径之间冲突时会报错，不悄悄改用其他安装。
+未指定版本时，已有运行实例保留原版本，新实例选择默认最新完整版本；
+显式指定版本可以主动升级已有实例。找不到旧实例版本时，会列出当前可用版本。
+
+### 非标准目录与资源要求
+
+显式 EXE 位于标准目录时，会反推关联下载目录；若同时指定下载目录，二者必须一致。
+EXE 父目录不是版本号时，必须另外配置 `engine_version`。这里的版本是声明或目录信息，
+不是对二进制内部版本的验证。
+
+独立 EXE 可被发现，但仍需通过 `mcs_download_path` 或有效注册表定位资源目录。
+当前本地世界启动需要下载目录中的 `componentcache/support/steve/steve.png`，
+以及 `%APPDATA%/MinecraftPE_Netease/games/com.netease` 用户数据目录。
+编辑器另需下载目录中的 `MCX64Editor/MC_Editor.exe`、`EngineAssert` 和启动器安装目录中的
+`data/inner_res`；Safaia 单独检查。缺少资源时按诊断提示补齐，本工具不自动下载这些资源。
+
+此功能不包含指定 IP/端口的第三方网络服启动。

mcpywrap-0.3.1/docs/local-dependencies.md

@@ -0,0 +1,65 @@
+# 本地目录依赖参考
+
+主项目仍使用 `pyproject.toml` 管理项目；引用的 Addon 可以是直接从 MCS 导出的目录，**无需 `mcpy init`、无需 `pyproject.toml`，也无需 pip 安装**。
+
+```toml
+[project]
+name = "my-addon"
+version = "0.1.0"
+dependencies = ["published-addon>=1.0"]
+
+[tool.mcpywrap]
+project_type = "addon"
+target_dir = "./build"
+local_dependencies = [
+    "../shared-addon",
+    "D:/Minecraft/common-resources",
+]
+```
+
+有效目录至少包含一个行为包或资源包及其 `manifest.json` 或 `pack_manifest.json`，例如：
+
+```text
+shared-addon/
+  behavior_pack/        # 也支持 behavior_pack_*、BehaviorPack*
+    manifest.json
+    sharedScript/
+  resource_pack/        # 也支持 resource_pack_*、ResourcePack*
+    manifest.json
+```
+
+第一版不支持把单独的行为包／资源包、地图根目录、普通源码目录作为本地依赖，也不支持同一 Addon 中多个同类型包。不必同时具备行为包和资源包。
+
+相对路径相对于**声明它的项目目录**解析，与执行命令前的其他工作目录无关。目标目录存在 `[tool.mcpywrap]` 时，继续读取该项目的 Python 和本地依赖；否则视为叶节点。读取不会初始化、安装或修改目标目录。重复引用按真实路径去重（包含 Windows 大小写和目录链接）；循环引用会报告引用链。同名目录使用不同内部标识，避免链接覆盖。
+
+```powershell
+mcpy add --path "../共享 Addon"
+mcpy add --path "D:/Minecraft/common-resources"
+mcpy remove --path "../共享 Addon"
+
+# 不带参数进入来源选择／直接依赖选择向导
+mcpy add
+mcpy remove
+```
+
+CLI 保留传入的相对或绝对写法，不根据包参数猜测路径。`--path` 不能与包参数同时使用；本地移除不接受 `--uninstall`。目录失效后仍可移除声明。非交互环境必须传入参数，否则返回非零退出码。`mcpy init` 的依赖收集也支持两种来源。
+
+添加目录时会先验证结构和依赖图，无效或循环引用不会写入配置。其 Python 依赖未安装或版本不满足时，会显示警告及可复制的 `mcpy add "requirement"` 命令，允许保存本地引用，但**不会自动安装**。构建、运行、编辑器启动前会重新完整校验。Python 包仍通过当前工具环境的 pip 安装，安装失败不保存新增声明；环境标记为假的 requirement 不参与当前平台的依赖图，普通 Python 库也不会当成 Addon 加载。
+
+### GUI 添加与移除
+
+运行 `mcpy ui`，在“添加新依赖”选择“Python 包”或“本地目录”。包模式支持可编辑下拉框及补全，安装在后台执行，完成前禁用冲突操作；失败会保留输入并显示原因。
+
+本地模式可输入路径或“浏览目录”，预览解析后的目录、包结构和将保存的路径。默认保存相对路径；跨盘保存绝对路径，也可勾选“保存为绝对路径”。**选择目录本身不保存，点击“添加依赖”才写入配置**。错误输入保留供修改。
+
+依赖列表显示来源、声明和不可用状态，详细原因显示在提示中。移除本地依赖的确认框会说明仅移除引用，源目录保留。每次修改后刷新运行包集合，每次启动前重新校验；失效依赖可继续移除。配置更新只影响后续启动，不自动更改正在运行的游戏。
+
+### 构建顺序与迁移
+
+旧配置无需迁移，省略 `local_dependencies` 等同于空数组。只有本地依赖、没有 Python 包依赖的项目同样支持 `build/run/edit/dev`（地图项目仍不支持 `dev`）。本地引用只用于此工具，**不会自动成为可通过 pip 分发、安装或锁定的依赖**；分发时需自行安排资源和路径。
+
+**行为变更：完整构建和增量构建现在都以主项目为最高优先级。** 顺序为子依赖先于引用者；同级先 Python 包列表、再本地列表，各列表按声明顺序处理，后处理者覆盖重复文件／合并键；主项目最后。共享子依赖只处理一次，采用稳定的依赖优先遍历。保留已有 JSON／语言文件合并规则及主项目 manifest。删除高优先级来源文件后，增量构建会恢复低优先级来源内容。
+
+构建在清空输出前校验依赖及路径，拒绝输出覆盖源项目／源包或与依赖目录重叠。`dev` 监控主项目和解析到的所有依赖目录，修改依赖声明后需要重启监控。
+
+`run/edit` 仍将依赖作为独立包链接／编辑器包路径传递，以上构建覆盖规则不代表游戏引擎自身的资源包加载优先级。Windows 优先使用符号链接，无符号链接权限时可使用目录 junction；复用已有同目标链接，保留其他项目链接，同名冲突明确报错。

mcpywrap-0.3.1/docs/releasing.md

@@ -0,0 +1,23 @@
+# 发布流程
+
+主分支和 PR 运行 Windows Python 3.9、3.12、3.14 的自动化测试。通过后构建 wheel/sdist、运行严格元数据检查、检查产物内容，并在独立环境安装 wheel 验证 CLI 和模块导入。
+
+发布凭据使用 PyPI Trusted Publishing，不在仓库或工作流中保存长期 API token。在 PyPI 项目 `mcpywrap` 的 Publishing 设置添加 GitHub publisher：
+
+| 字段 | 值 |
+|---|---|
+| Owner | `EaseCation` |
+| Repository | `mcpywrap` |
+| Workflow filename | `release.yml` |
+| Environment | `pypi` |
+
+每次发布：
+
+1. 同步修改 `pyproject.toml` 和 `mcpywrap/__init__.py` 中的版本，更新 CHANGELOG。
+2. 将通过本地验证的提交推送到 `main`，等待 CI 全部通过。
+3. 在该提交创建匹配版本的 `vX.Y.Z` 标签并推送，触发 CI 再次检查及发布。标签版本必须匹配元数据，且提交必须位于 `main` 历史上。
+4. 检查 Actions 的 publish job 和 PyPI 新版本文件。发布失败时先排除原因；若是首次配置 publisher 尚未完成，可完成 PyPI 配置后重跑失败任务。
+
+也可手动运行 `release.yml`：选择 `main` 并设置 `publish=true`。默认手动运行只验证，不发布。发布只允许标签推送或显式开启发布的 main 手动运行，PR 和普通 main 推送均不会上传 PyPI。
+
+不要覆盖已有 PyPI 版本。发布动作开启 PyPI provenance attestations；各第三方 Action 固定到已核实的提交。GitHub `pypi` environment 与 PyPI publisher 的 environment 必须一致。

{mcpywrap-0.2.3 → mcpywrap-0.3.1}/mcpywrap/__init__.py

@@ -1,4 +1,4 @@
 # -*- coding: utf-8 -*-
 """mcpywrap - 将 Python 3 代码转换为 Python 2 代码的工具"""
 
-__version__ = '0.1.0'
+__version__ = '0.3.1'

{mcpywrap-0.2.3 → mcpywrap-0.3.1}/mcpywrap/builders/AddonsPack.py

@@ -49,12 +49,11 @@ class AddonsPack(object):
 
     def __init__(self, pkg_name, path, is_origin=False):
         self.pkg_name = pkg_name
-        self.path = path
+        self.path = os.path.abspath(path)
         self.is_origin = is_origin
         self.behavior_pack_dir = None
         self.resource_pack_dir = None
         # 进入此目录，查找内部的行为包和资源包的路径
-        os.chdir(self.path)
         for item in os.listdir(self.path):
             item_path = os.path.join(self.path, item)
             if os.path.isdir(item_path):
@@ -280,25 +279,15 @@ class AddonsPack(object):
                 包类型: "behavior" 或 "resource"
                 相对路径: 在包中的相对路径，如果不在包中则为None
         """
-        # 检查是行为包还是资源包文件
-        is_behavior = self.is_behavior_file(file_path)
-        is_resource = self.is_resource_file(file_path)
-        
-        if not (is_behavior or is_resource):
-            return False, None, None
-            
-        # 确定包类型
-        pack_type = "behavior" if is_behavior else "resource"
-        
-        # 计算在包中的相对路径
-        parts = file_path.split(os.sep)
-        for i, part in enumerate(parts):
-            if (is_behavior and ("behavior_pack" in part.lower() or "behaviorpack" in part.lower())) or \
-               (is_resource and ("resource_pack" in part.lower() or "resourcepack" in part.lower())):
-                if i + 1 < len(parts):
-                    rel_path = os.path.join(*parts[i+1:])
-                    return True, pack_type, rel_path
-                else:
-                    return True, pack_type, ""
-                
+        # Watchdog 可能返回短路径或目录链接路径；保留相对文件名大小写。
+        absolute = os.path.realpath(file_path)
+        for kind, folder in (("behavior", self.behavior_pack_dir), ("resource", self.resource_pack_dir)):
+            if not folder:
+                continue
+            folder = os.path.realpath(folder)
+            try:
+                if os.path.commonpath([os.path.normcase(absolute), os.path.normcase(folder)]) == os.path.normcase(folder):
+                    return True, kind, os.path.relpath(absolute, folder)
+            except ValueError:
+                continue
         return False, None, None

{mcpywrap-0.2.3 → mcpywrap-0.3.1}/mcpywrap/builders/MapPack.py

@@ -21,25 +21,23 @@ class MapPack(object):
     def __init__(self, pkg_name: str, path: str):
         self.pkg_name = pkg_name
         self.path = path
+        self.behavior_packs = []
+        self.resource_packs = []
 
         # 读取配置文件
         self.behavior_packs_dir = os.path.join(self.path, "behavior_packs")
         self.resource_packs_dir = os.path.join(self.path, "resource_packs")
 
-        if not os.path.exists(self.behavior_packs_dir):
-            os.makedirs(self.behavior_packs_dir)
 
         # 遍历行为包目录
-        for pack in os.listdir(self.behavior_packs_dir):
+        for pack in sorted(os.listdir(self.behavior_packs_dir)) if os.path.isdir(self.behavior_packs_dir) else []:
             pack_path = os.path.join(self.behavior_packs_dir, pack)
             if os.path.isdir(pack_path):
                 self.behavior_packs.append(pack_path)
         
-        if not os.path.exists(self.resource_packs_dir):
-            os.makedirs(self.resource_packs_dir)
 
         # 遍历资源包目录
-        for pack in os.listdir(self.resource_packs_dir):
+        for pack in sorted(os.listdir(self.resource_packs_dir)) if os.path.isdir(self.resource_packs_dir) else []:
             pack_path = os.path.join(self.resource_packs_dir, pack)
             if os.path.isdir(pack_path):
                 self.resource_packs.append(pack_path)

mcpywrap-0.3.1/mcpywrap/builders/assembly.py

@@ -0,0 +1,85 @@
+"""完整构建和增量更新共用相同的文件合并规则。"""
+import os
+import shutil
+from pathlib import Path
+
+from ..dependencies import DependencyError, canonical_path
+from .AddonsPack import MANIFEST_FILES
+from .file_merge import try_merge_file
+
+MERGED_JSON = {'blocks.json', 'terrain_texture.json', 'item_texture.json', 'sounds.json',
+               'sound_definitions.json', 'animations.json', 'animation_controllers.json',
+               'entity_models.json', 'render_controllers.json', 'materials.json',
+               'attachables.json', 'particle_effects.json', '_ui_defs.json'}
+
+
+def is_within(path, parent):
+    try:
+        return os.path.commonpath([canonical_path(path), canonical_path(parent)]) == canonical_path(parent)
+    except ValueError:
+        return False
+
+
+def validate_target(target, root, packs):
+    if not target:
+        raise DependencyError('未指定构建输出目录')
+    # 根目录下的独立 build 允许存在，但不能覆盖任意源包或依赖项目。
+    if is_within(root, target):
+        raise DependencyError(f'构建输出会覆盖主项目: {target}')
+    for pack in packs:
+        protected = [pack.path] if not pack.is_origin else [pack.behavior_pack_dir, pack.resource_pack_dir]
+        for source in filter(None, protected):
+            if is_within(source, target) or is_within(target, source):
+                raise DependencyError(f'构建输出与源目录重叠: {target} <-> {source}')
+
+
+def pack_files(pack, kind):
+    folder = getattr(pack, kind + '_pack_dir')
+    if not folder or not os.path.isdir(folder):
+        return
+    for current, dirs, files in os.walk(folder):
+        dirs[:] = sorted(d for d in dirs if not pack.should_exclude(os.path.join(current, d)))
+        for name in sorted(files):
+            source = Path(current) / name
+            if name in MANIFEST_FILES or not pack.should_exclude(str(source)):
+                yield source.relative_to(folder).as_posix()
+
+
+def rebuild_file(packs, kind, relative, destination):
+    """按依赖优先序重建单个产物；所有来源删除后同步删除产物。"""
+    destination = Path(destination)
+    if destination.is_file() or destination.is_symlink():
+        destination.unlink()
+    sources = []
+    for pack in packs:
+        folder = getattr(pack, kind + '_pack_dir')
+        if not folder:
+            continue
+        source = Path(folder) / relative
+        if source.is_file() and (source.name in MANIFEST_FILES or not pack.should_exclude(str(source))):
+            sources.append((pack, source))
+    if relative in MANIFEST_FILES:
+        # 优先保留主包 manifest；主包缺少该包类型时使用最后一个依赖的 manifest。
+        manifest_owner = next((pack for pack in reversed(packs)
+                               if getattr(pack, kind + '_pack_dir') and any(
+                                   (Path(getattr(pack, kind + '_pack_dir')) / name).is_file()
+                                   for name in MANIFEST_FILES)), None)
+        sources = [(pack, source) for pack, source in sources if pack is manifest_owner]
+    for pack, source in sources:
+        destination.parent.mkdir(parents=True, exist_ok=True)
+        if destination.exists() and (source.name in MERGED_JSON or source.suffix == '.lang'):
+            success, error = try_merge_file(str(source), str(destination))
+            if not success:
+                raise DependencyError(error)
+        elif source.suffix == '.py':
+            pack._copy_with_encoding_check(str(source), str(destination))
+        else:
+            shutil.copy2(source, destination)
+
+
+def assemble_addon(packs, target_pack):
+    for kind in ('behavior', 'resource'):
+        target = getattr(target_pack, kind + '_pack_dir')
+        paths = {relative for pack in packs for relative in pack_files(pack, kind)}
+        for relative in sorted(paths):
+            rebuild_file(packs, kind, relative, Path(target) / relative)