python-git-program-launcher

自动安装并启动基于git管理的python程序。

特点

• 可以作为pypi包下载安装，并打包自己的python程序:
  • 体积小，打包后不携带依赖项，在安装时才下载，最小打包后体积5MB；
  • 不易出错，与pyinstaller相比，不直接打包dll，避免打包缺失；
  • 下载速度快，自动检测多个代理源，GFW内外均可顺利使用；
  • 启动器与打包的项目均有自动更新功能，一键更新，无需重装；
  • 运行简单直观，打包后仅有Launcher.exe和极少文件暴露在外，傻瓜用户也不易点错。
• 一键启动python程序，终极傻瓜包
• 使用git自动更新仓库
• 基于pywebio, webview和pyqt的GUI界面
• 允许使用不同的配置，管理不同python版本的不同仓库。
• 允许启动多个程序。
• 自动下载并安装python和pip包。
• 从Github仓库自动下载预配置文件
• 丰富的的自定义配置

使用

直接运行

下载最新的Release。

运行Launcher.exe。

不要打开除了Watt Toolkit之外的所有可能干扰网络连接的软件，包括Clash/部分游戏加速器/网络连接管理/下载加速器等，它们会干扰SSL验证。

从pip安装并打包自己的程序（新功能）

输入以下命令安装pgpl

pip install pgpl

使用：

python -m pgpl build --name your-project-name --target-dir your-project-folder-path --output-path the-folder-to-save-packed-file --main the-entry-python-file.py 

--requirements-file(optional) the name of requirements file for pip, default to "requirements.txt" 
--use-UAC(optional) set true if the-program should use UAC, default to false
--python-version(optional) python-version, should be "3.xx.xx", default to "3.10.10"

All the file under the target folder will be included.

打包后的文件会放在output-dir下，并会自动压缩为zip。

源代码运行

下载最新的Release。

运行Launcher.exe，等待完成。

完成后，Launcher.exe的同级文件夹会有python-git-program_launcher的文件夹，打开后，运行gui.py即可。

添加配置

从Github自动下载

如果你要添加的仓库有pgpl.yaml文件，你可以在添加配置时输入Github仓库地址，从而自动下载并识别远程仓库的配置文件。
如果你在大陆，推荐使用Watt Toolkit加速Github。极其强烈不推荐使用Clash，因为它会干扰ssl验证。

手动添加

按照软件内说明操作。同时按照设置配置中的说明填写。

使用自带配置

PGPL自带GIA和SRC的启动配置，无需添加即可使用。

故障排查

频繁出现的故障：

1. 使用了网络代理软件导致ssl验证错误。必须关闭Clash/游戏加速器/网络连接管理/下载加速器
2. 没有启用长路径支持导致路径超过上限。你可以运行EnableLongPath.reg解决此问题。如果你不信任该文件，你可以在如下链接中找到相同解决方案。
   https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=registry#enable-long-paths-in-windows-10-version-1607-and-later

请注意，该方法仅支持Windows10-1607之后的版本。

设置配置

配置项	内容	默认值
RequirementsFile	requirement文件位置	requirements.txt
InstallDependencies	是否安装pip依赖	true
PypiMirror	pypi镜像地址	AUTO
PythonMirror	python镜像地址	AUTO
Repository	仓库地址	https://github.com/infstellar/python-git-program-launcher
Main	python执行文件	main.py
Branch	分支	main
GitProxy	是否开启Git验证	false
KeepLocalChanges	是否保持本地更改	false
AutoUpdate	是否自动更新	true
Tag	tag，有tag时优先使用tag，否则使用branch。
PythonVersion	python版本，必须为有效版本(3.x.y)	3.10.10
UAC	是否需求UAC	True

TODO:

• 修改pip缓存默认位置

文件位置

日志位置

./Logs/yyyy-mm-dd/yyyy-mm-dd.log

仓库保存位置

./repositories

python保存位置

./toolkit/python

缓存位置

./cache

范例配置

SRC
GIA

鸣谢

ALAS-EasyInstaller
GIA
pywebio
pywebview
pyqt
loguru