mcpywrap 0.2.2__tar.gz → 0.3.0__tar.gz

mcpywrap-0.3.0/CHANGELOG.md

@@ -0,0 +1,15 @@
+# 更新记录
+
+## 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.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 EaseCation®️
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcpywrap-0.3.0/MANIFEST.in

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

mcpywrap-0.3.0/PKG-INFO

@@ -0,0 +1,232 @@
+Metadata-Version: 2.4
+Name: mcpywrap
+Version: 0.3.0
+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 
+
+**《我的世界》中国版 ModSDK 与资源包的全周期管理工具**
+
+[![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 是基于 Python 生态的《我的世界》中国版 ModSDK/资源包全周期管理工具，支持依赖管理、语法转换和自动化构建，助力开发者实现高效协作与代码复用。
+
+## 🌟 核心特性
+
+- 🧩 **模块化开发** - 基于 Addons 维度的依赖管理（基于包管理和依赖的开发与测试流程）
+- 🔄 **现代语法** - 支持 Python3 现代语法特性，提升开发体验
+- 📦 **生态兼容** - 无缝对接 PyPI 生态，支持标准 `pyproject.toml` 配置
+- 🚀 **智能构建** - 一键打包符合 MCStudio 规范的成品 Addons
+- 🔥 **热重载开发** - 实时监控代码变更，支持 MCStudio 热更新
+
+## 📖 为何选择此工具？
+
+### 传统开发痛点
+- 📜 **代码复用困难** - 通过 **文件拷贝** 导致版本管理混乱
+- 🚧 **协作效率低下** - 多项目 **重复代码** 维护成本高
+- ⚠️ **代码质量** - 缺乏现代开发工具和语法支持
+
+### mcpywrap 解决方案
+1. **标准化开发**  
+通过 `pyproject.toml` 声明项目元数据和依赖关系，实现真正的模块化开发
+
+2. **直接启动测试和编辑**  
+- 直接通过 `mcpy run` 启动游戏实例，支持热重载和实时构建，提升开发效率
+- 通过 `mcpy edit` 命令，使用 MC Studio Editor 编辑器进行编辑
+
+3. **生态集成**  
+依托 pip 包管理体系，支持依赖的版本锁定和自动解析
+
+
+## 🚀 快速开始
+
+### 前置要求
+- Python ≥ 3.9（游戏与编辑器启动需要 Windows 和 MC Studio）
+- pip ≥ 21.0
+
+### 安装
+```bash
+pip install mcpywrap
+```
+
+### 初始化项目
+```bash
+# 首先进入项目目录
+mcpy init
+```
+交互式创建项目结构，自动生成标准的 Mod 框架。
+
+### 运行测试
+```bash
+mcpy run
+```
+
+## 🛠 工作流指南
+
+### 依赖管理
+| 命令                          | 说明                  |
+|-------------------------------|---------------------|
+| `mcpy`                 | 维护项目，将项目安装到系统 site-package 环境            |
+| `mcpy add "package>=1.0"` | 安装并声明 Python 包依赖 |
+| `mcpy add --path ../common` | 直接引用本地 Addon 目录 |
+| `mcpy remove <package>`        | 移除依赖               |
+
+### 完整命令参考
+
+```bash
+mcpy --help
+```
+
+#### 依赖管理
+| 命令                          | 说明                  |
+|-------------------------------|---------------------|
+| `mcpy add "package>=1.0"` | 安装成功后保存 Python 包声明 |
+| `mcpy add --path ../common` | 添加本地 Addon 目录，无需初始化或安装该目录 |
+| `mcpy remove <package>`        | 从项目配置中删除依赖并可选择卸载 |
+| `mcpy remove --path ../common` | 仅移除本地引用，保留源目录 |
+
+### 本地目录依赖
+
+主项目仍使用 `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；复用已有同目标链接，保留其他项目链接，同名冲突明确报错。
+
+### 开发验证
+
+```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 文件收集器，真实引擎、目录链接和运行配置均使用产品实现。
+
+#### 项目初始化与开发
+| 命令                          | 说明                  |
+|-------------------------------|---------------------|
+| `mcpy init`                   | 交互式初始化项目，创建基础的包信息及配置 |
+| `mcpy mod`                    | 向导式创建 Python Mod 基础框架 |
+| `mcpy build`                  | 构建为 MCStudio 工程 |
+| `mcpy dev`                    | 使用watch模式，实时构建与热重载 |
+| `mcpy edit`                   | 使用 MC Studio Editor 编辑器进行编辑 |
+
+#### ModSDK与游戏实例
+| 命令                          | 说明                  |
+|-------------------------------|---------------------|
+| `mcpy modsdk`                 | 管理网易我的世界ModSDK |
+| `mcpy run`                    | 游戏实例运行与管理 |
+
+#### 发布项目
+| 命令                          | 说明                  |
+|-------------------------------|---------------------|
+| `mcpy publish`                | 发布项目到 PyPI |
+
+#### 游戏实例管理详解
+
+```bash
+# 启动最新游戏实例
+mcpy run
+
+# 创建新的游戏实例
+mcpy run -n
+
+# 列出所有可用的游戏实例
+mcpy run -l
+
+# 删除指定的游戏实例
+mcpy run -d <实例ID前缀>
+```
+
+## 🤝 参与贡献
+欢迎提交 Issue 和 PR！请先阅读 [贡献指南](CONTRIBUTING.md)。
+
+## 开源协议
+[MIT License](LICENSE) © 2025 EaseCation

mcpywrap-0.3.0/README.md

@@ -0,0 +1,206 @@
+# 🧰 mcpywrap 
+
+**《我的世界》中国版 ModSDK 与资源包的全周期管理工具**
+
+[![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 是基于 Python 生态的《我的世界》中国版 ModSDK/资源包全周期管理工具，支持依赖管理、语法转换和自动化构建，助力开发者实现高效协作与代码复用。
+
+## 🌟 核心特性
+
+- 🧩 **模块化开发** - 基于 Addons 维度的依赖管理（基于包管理和依赖的开发与测试流程）
+- 🔄 **现代语法** - 支持 Python3 现代语法特性，提升开发体验
+- 📦 **生态兼容** - 无缝对接 PyPI 生态，支持标准 `pyproject.toml` 配置
+- 🚀 **智能构建** - 一键打包符合 MCStudio 规范的成品 Addons
+- 🔥 **热重载开发** - 实时监控代码变更，支持 MCStudio 热更新
+
+## 📖 为何选择此工具？
+
+### 传统开发痛点
+- 📜 **代码复用困难** - 通过 **文件拷贝** 导致版本管理混乱
+- 🚧 **协作效率低下** - 多项目 **重复代码** 维护成本高
+- ⚠️ **代码质量** - 缺乏现代开发工具和语法支持
+
+### mcpywrap 解决方案
+1. **标准化开发**  
+通过 `pyproject.toml` 声明项目元数据和依赖关系，实现真正的模块化开发
+
+2. **直接启动测试和编辑**  
+- 直接通过 `mcpy run` 启动游戏实例，支持热重载和实时构建，提升开发效率
+- 通过 `mcpy edit` 命令，使用 MC Studio Editor 编辑器进行编辑
+
+3. **生态集成**  
+依托 pip 包管理体系，支持依赖的版本锁定和自动解析
+
+
+## 🚀 快速开始
+
+### 前置要求
+- Python ≥ 3.9（游戏与编辑器启动需要 Windows 和 MC Studio）
+- pip ≥ 21.0
+
+### 安装
+```bash
+pip install mcpywrap
+```
+
+### 初始化项目
+```bash
+# 首先进入项目目录
+mcpy init
+```
+交互式创建项目结构，自动生成标准的 Mod 框架。
+
+### 运行测试
+```bash
+mcpy run
+```
+
+## 🛠 工作流指南
+
+### 依赖管理
+| 命令                          | 说明                  |
+|-------------------------------|---------------------|
+| `mcpy`                 | 维护项目，将项目安装到系统 site-package 环境            |
+| `mcpy add "package>=1.0"` | 安装并声明 Python 包依赖 |
+| `mcpy add --path ../common` | 直接引用本地 Addon 目录 |
+| `mcpy remove <package>`        | 移除依赖               |
+
+### 完整命令参考
+
+```bash
+mcpy --help
+```
+
+#### 依赖管理
+| 命令                          | 说明                  |
+|-------------------------------|---------------------|
+| `mcpy add "package>=1.0"` | 安装成功后保存 Python 包声明 |
+| `mcpy add --path ../common` | 添加本地 Addon 目录，无需初始化或安装该目录 |
+| `mcpy remove <package>`        | 从项目配置中删除依赖并可选择卸载 |
+| `mcpy remove --path ../common` | 仅移除本地引用，保留源目录 |
+
+### 本地目录依赖
+
+主项目仍使用 `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；复用已有同目标链接，保留其他项目链接，同名冲突明确报错。
+
+### 开发验证
+
+```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 文件收集器，真实引擎、目录链接和运行配置均使用产品实现。
+
+#### 项目初始化与开发
+| 命令                          | 说明                  |
+|-------------------------------|---------------------|
+| `mcpy init`                   | 交互式初始化项目，创建基础的包信息及配置 |
+| `mcpy mod`                    | 向导式创建 Python Mod 基础框架 |
+| `mcpy build`                  | 构建为 MCStudio 工程 |
+| `mcpy dev`                    | 使用watch模式，实时构建与热重载 |
+| `mcpy edit`                   | 使用 MC Studio Editor 编辑器进行编辑 |
+
+#### ModSDK与游戏实例
+| 命令                          | 说明                  |
+|-------------------------------|---------------------|
+| `mcpy modsdk`                 | 管理网易我的世界ModSDK |
+| `mcpy run`                    | 游戏实例运行与管理 |
+
+#### 发布项目
+| 命令                          | 说明                  |
+|-------------------------------|---------------------|
+| `mcpy publish`                | 发布项目到 PyPI |
+
+#### 游戏实例管理详解
+
+```bash
+# 启动最新游戏实例
+mcpy run
+
+# 创建新的游戏实例
+mcpy run -n
+
+# 列出所有可用的游戏实例
+mcpy run -l
+
+# 删除指定的游戏实例
+mcpy run -d <实例ID前缀>
+```
+
+## 🤝 参与贡献
+欢迎提交 Issue 和 PR！请先阅读 [贡献指南](CONTRIBUTING.md)。
+
+## 开源协议
+[MIT License](LICENSE) © 2025 EaseCation

mcpywrap-0.3.0/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.2 → mcpywrap-0.3.0}/mcpywrap/__init__.py

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

{mcpywrap-0.2.2 → mcpywrap-0.3.0}/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.2 → mcpywrap-0.3.0}/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)