魔兽世界插件管理器
项目描述
instawow是魔兽世界的插件管理器。它可用于从 GitHub、CurseForge、WoWInterface 和 Tukui 安装、更新和删除附加组件。 instawow有一个可互操作的 CLI 和 GUI、带有下载评分的模糊搜索和其他几个好东西。
<图>
</图>
|
<图>
</图>
|
安装
您可以从 GitHub下载instawow的预构建二进制文件：
如果您希望从源代码安装instawow，您可以选择：
pipx : 用于 GUI 的pipx install instawow或pipx install instawow[gui]
香草 pip： python -m pip install -U instawow或python -m pip install -U instawow[gui]用于 GUI
命令行操作
tl;博士
首先运行instawow reconcile以使用instawow 注册以前安装的附加组件 （或instawow reconcile --auto以在没有用户输入的情况下执行相同操作）。要安装附加组件，您可以使用搜索命令搜索它们：
instawow search molinari
此外，instawow能够解释插件 URL 和instawow特定的 slug 和主机 ID 的 URN。以下所有内容将从 CurseForge 安装 Molinari：
instawow install https://www.curseforge.com/wow/addons/molinari instawow install curse:molinari instawow install curse:20338
您可以像安装它们一样更新和删除它们。如果在没有参数的情况下调用更新，它将更新所有已安装的附加组件。您可以使用list --format detail列出附加组件并查看有关它们的详细信息。对于列表和类似的非破坏性命令，可以省略源代码并且可以缩写 slug，例如instawow reveal moli 将在您的文件管理器中打开 Molinari 附加文件夹。
附加对账
附加组件协调不是自动的 - instawow 强调不会自动承担附加组件的所有权。但是，您可以使用reconcile --auto自动进行协调， 并且instawow将优先考虑来自 CurseForge 的附加组件。由于无法可靠地提取已安装的版本，因此会重新安装已协调的附加组件。
附加搜索
instawow带有一个基本的搜索命令，根据编辑距离和受欢迎程度对结果进行排名。搜索使用每天更新一次的已整理附加目录 。您可以直接从搜索中安装多个附加组件。
恢复附加更新
instawow会记录之前安装的插件的所有版本。可以使用instawow rollback命令撤消附加更新。已回滚的加载项被固定，不会收到更新。回滚本身可以通过instawow rollback --undo撤消，它将使用默认策略安装指定插件的最新版本。
简介
instawow通过配置文件支持多个游戏版本。假设您的默认配置文件配置为零售，您可以为经典创建一个原始配置文件：
instawow -p classic configure
“经典”只是配置文件的名称；您将被要求选择它对应的游戏风格。您可以拥有多个相同风格的配置文件（想想 alpha、beta 和 PTR）。
-p是一个全局选项。您可以在任何instawow命令前加上-p。例如，要更新您的 Classic 附加组件，您将运行：
instawow -p classic update
如果存在默认配置文件，您可以省略-p。
迁移经典配置文件
除了“Classic Era”配置文件（instawow用语中的vanilla_classic ）外，一旦instawow支持，经典配置文件将开始接收最新 Classic 版本的 更新。除了更新instawow 之外，无需用户干预。
WeakAura 更新程序
instawow包含一个仿照 WeakAuras Companion的 WeakAura 更新程序。要使用更新程序并假设您已安装 WeakAuras：
instawow weakauras-companion build instawow install instawow:weakauras-companion
您必须在更新之前重新构建配套插件才能接收光环更新。如果您想在每次调用instawow update时检查更新，请安装 instawow:weakauras-companion-autoupdate变体：
instawow install instawow:weakauras-companion-autoupdate instawow update
插件
instawow可以使用插件进行扩展。插件可用于添加对任意主机的支持并向 CLI 添加新命令。您将在tests/plugin中找到一个示例插件。
元数据采购
诅咒熔炉
CurseForge 将在 2022 年第一季度末停用其未经身份验证的附加 API。CurseForge 将有条件地为新 API 颁发密钥，并且哪些附加管理器有义务隐藏。因此，除了通过代理服务之外，新的 API 对附加管理器是不可行的，而这个特定附加管理器的作者负担不起。同时，CurseForge 将为作者提供从新 API 中取消列出其附加组件的选项，并且通过新 API 启动的下载将不计入广告收益分享计划的作者积分。
GitHub
instawow支持在 GitHub 上发布的WoW 附加组件——也就是说，存储库必须有一个版本（标签不起作用），并且该版本必须附加一个附加 ZIP 文件作为资产。 instawow不会直接从源代码、tarball 或“zipball”安装或构建附加组件，也不会验证 ZIP 文件的内容。
透明度
由instawow发起的 Web 请求可以通过其用户代理字符串来识别。
每 24 小时，instawow将在启动时查询PyPI（规范的 Python 包索引）以检查instawow更新。
贡献
欢迎提交错误报告和修复。在承诺进行任何重大更改之前，请务必打开一个问题。
