获取 you-get.exe
PyInstaller bundles a Python application and all its dependencies into a single package. The user can run the packaged app without installing a Python interpreter or any modules.
本文将叙述如何使用 PyInstaller 将 you-get 打包为可独立运行的 exe 程序 (Windows)。
Preparation
依次安装以下依赖或运行相应命令。
- Python 3.7-3.9
根据 PyInstaller 的说明文档,其目前(2020-11-18)支持的 Python 版本为 3.5-3.9。若需创建32位的可执行文件,请在32位Python环境下运行PyInstaller。 PyInstaller
1
2# 可以加上使用镜像源的参数: --index-url=https://pypi.tuna.tsinghua.edu.cn/simple
$ pip install pyinstallerGit clone
1$ git clone https://github.com/soimort/you-get.git此外,下文在测试时(2020-02-18),使用的各程序版本为:
- Python:
3.7.6 - you-get:
0.4.1403 - PyInstaller:
3.6
- Python:
Options
根据 Using PyInstaller — PyInstaller 3.6 documentation 所述,打包一个简单 Python 程序的命令为:
1 | pyinstaller myscript.py |
添加 -F 参数即可打包为单个可执行文件:
1 | pyinstaller -F myscript.py |
PyInstaller 会自动在当前目录下生成 build/ , dist/ , myscript.spec ,并且打包好的 myscript.exe 文件就在 dist/ 目录下。
但要打包 you-get 这样的项目,需要处理其中一些模块依赖的问题。虽然 PyInstaller 能够自行分析项目的模块依赖,但对于一些特殊情况,需要提供额外参数来解决模块依赖的问题。
Attempt
你可以 跳过 这一节,直接查看最终的命令。本节将叙述最终命令中各参数的意义。
首先进入 git clone 下来的 you-get 项目目录
1 | $ cd you-get |
尝试使用 PyInstaller 直接打包:
1 | > pyinstaller -F you-get |
打包成功后,尝试运行则报错 No module named 'you_get' :
1 | > cd dist |
查阅 Helping PyInstaller Find Modules 后得知,由于 ./you-get 中使用了 sys.path ,需要通过 --path 参数为 PyInstaller 指明 you_get 这个模块在哪(即 ./src 目录下)。
1 | > cd .. |
可以看到已经能正确输出版本号了,接下来试试获取视频信息:
1 | > you-get.exe -i https://www.bilibili.com/video/av59988590/ |
直接报错了,试试加上 --debug 参数:
1 | > you-get.exe -i https://www.bilibili.com/video/av59988590/ --debug |
那就尝试导入 you_get.extractors
1 | > cd .. |
似乎一切正常,但为了避免潜在问题,不妨将 src/you_get/cli_wrapper/ , src/you_get/processor/ , src/you_get/util/ 也都导入并打包:
1 | > pyinstaller -F --path=src you-get --hidden-import=you_get.extractors --hidden-import=you_get.cli_wrapper --hidden-import=you_get.processor --hidden-import=you_get.util |
可以看到即使提供了四个 --hidden-import 参数,其导入时只用到了 you_get.extractors 和 you_get.cli_wrapper ,即便更换顺序也同样如此:
1 | > pyinstaller -F --path=src you-get --hidden-import=you_get.processor --hidden-import=you_get.cli_wrapper --hidden-import=you_get.util --hidden-import=you_get.extractors |
暂不清楚其与下面的打包命令的结果有何不同,可能需要深入了解 PyInstaller 的工作原理和 You-Get 内部模块间的调用关系才能知晓。
1 | > pyinstaller -F --path=src you-get --hidden-import=you_get.extractors --hidden-import=you_get.cli_wrapper |
Issues
网站支持
目前即使是 "通过 pip 安装的 you-get" 也似乎无法下载爱奇艺;解析腾讯视频只有单一清晰度。对此请通过 annie 下载。
1 | $ you-get --format=LD https://www.iqiyi.com/v_19ruzj8gv0.html |
特殊情况
对于某些视频网站(如西瓜视频),使用 "通过 pip 安装的 you-get" 能正常下载,而使用 "以上文方法打包的 you-get.exe" 则无法下载,例如:
1 | # 正常下载 |
根据提示导入 you_get.extractors.ixigua 重新打包后,能够正常下载。
1 | > pyinstaller -F --path=src you-get --hidden-import=you_get.extractors --hidden-import=you_get.cli_wrapper --hidden-import=you_get.processor --hidden-import=you_get.util --hidden-import=you_get.extractors.ixigua |
导致需要额外导入单个站点模块的原因可能是 src/you_get/extractors/__init__.py 中没有以下语句:
1 | from .ixigua import * |
若加上这一句后再执行打包,则无需 --hidden-import=you_get.extractors.ixigua 也能正常下载。
1 | > pyinstaller -F --path=src you-get --hidden-import=you_get.extractors --hidden-import=you_get.cli_wrapper --hidden-import=you_get.processor --hidden-import=you_get.util |
与之相同的,在 src/you_get/extractors/ 目录下有对应 extractor (100) 却未在 src/you_get/extractors/__init__.py (88) 中 import 的站点有:
- baomihua.py
- giphy.py
- huomaotv.py
- iwara.py
- ixigua.py
- missevan.py
- qie_video.py
- qq_egame.py
- toutiao.py
- vidto.py
- ximalaya.py
- yizhibo.py
此外还有一些出现在 Release 的 you-get-0.4.1403.tar.gz 中,却不在 GitHub 源码中的 extractors (10),包含:
- _blip.py
- _catfun.py
- _coursera.py
- _dongting.py
- _jpopsuki.py
- _qianmo.py
- _songtaste.py
- _thvideo.py
- _vid48.py
- _videobam.py
这些 extractors 均以 _ 开头,而(参照 Makefile)直接运行 python setup.py sdist生成的 dist/you-get-0.4.1403.tar.gz 则不包含这些 extractors 。 暂不知其原因。
根据上文分析,可以想到解决办法为:将 "you-get-0.4.1403.tar.gz" you-get-0.4.1403/src/you_get/extractors/ 中以 _ 开头的 py 文件复制到 clone 目录对应位置,并编辑 src/you_get/extractors/__init__.py ,在其中逐一导入这些模块,最后再重新打包。
1 | # 为 src/you_get/extractors/__init__.py 文件追加以下语句 |
Final command
综上所述,最后打包的命令为:
1 | > pyinstaller -F --path=src you-get --hidden-import=you_get.extractors --hidden-import=you_get.cli_wrapper --hidden-import=you_get.processor --hidden-import=you_get.util |
参考资料
Using PyInstaller — PyInstaller 3.6 documentation
When Things Go Wrong — PyInstaller 3.6 documentation
- pyinstaller 打包you-get命令 - OSCHINA