Installation

🛠️ 下载安装

方式一 - 下载已构建的可执行文件

1. Mys_Goods_Tool V2 可从 🔗Releases 页面下载由 GitHub Actions 程序自动打包的可执行文件

2. 下载后解压，进入解压目录，即可在 dist/ 目录下找到可执行文件 Mys_Goods_Tool 或 Mys_Goods_Tool.exe

3. 可选：对于非 Windows 的操作系统，可安装 uvloop 包，以获得更好的性能
   使用软件包管理器如 apt 安装

   sudo apt install python3-uvloop

   其他软件包管理器请自行查询资料

4. 运行可执行文件

   • 双击打开
   • 如果出现了日志没有的报错信息，但由于程序自动关闭而很难观察到，
     可在程序目录下打开终端，执行下面的命令来运行
     • Windows

       .\Mys_Goods_Tool.exe

     • Linux / macOS

       # 授予可执行权限
       chmod +x ./Mys_Goods_Tool
       # 执行
       ./Mys_Goods_Tool

方式二 - 通过 PyPI 下载包

1. 配置 Python 环境

   • 🔗Python 版本要求：3.9 - 3.11
   • 建议创建虚拟环境，以免依赖管理混乱，有以下几种方式
     • 使用 Virtualenv (Python 自带)

       # 该示例命令适用于 Linux / macOS
       ## 创建虚拟环境
       python -m venv <虚拟环境路径>
       ## 激活虚拟环境
       source <虚拟环境路径>/bin/activate

     • 使用 conda（省略，参考 🔗官方文档）
     • 使用 Poetry（省略，参考 🔗官方文档）

2. 安装 mys-goods-tool 包

   pip install mys-goods-tool

3. 可选：对于非 Windows 的操作系统，可安装 uvloop 包，以获得更好的性能

   • 使用软件包管理器如 apt 安装（推荐）

     sudo apt install python3-uvloop

     注意：如果使用了Virtualenv，需要修改虚拟环境目录下的 pyvenv.cfg 文件的 include-system-site-packages 为 true 以支持导入系统包
     其他软件包管理器、虚拟环境请自行查询资料
   • 使用 pip 安装

     pip install mys-goods-tool[uvloop]

   • 使用 poetry 安装

     poetry install mys-goods-tool --with uvloop

4. 运行，注意用户数据文件和日志默认将在当前工作目录下生成

   python -m mys_goods_tool