python - 使用 Pyinstaller 或 Cython 从 Python 模块创建可执行文件

Question

我想转换成可执行文件this具有模块结构的python 2.7项目:

(.venv) ip-192-168-22-127:indictrans loretoparisi$ tree -L 1
.
├── __init__.py
├── __init__.pyc
├── __init__.spec
├── _decode
├── _utils
├── base.py
├── build
├── mappings
├── models
├── script_transliterate.py
├── tests
├── transliterator.py
└── trunk

我正在使用 pyinstaller为此，在第一阶段，我只是在做:

pyinstall --onefile __init__.py

我得到了一个可执行文件:

192 INFO: PyInstaller: 3.3.1
192 INFO: Python: 2.7.10
201 INFO: Platform: Darwin-17.7.0-x86_64-i386-64bit
202 INFO: wrote /Users/loretoparisi/Documents/Projects/AI/indic-trans/indictrans/__init__.spec
208 INFO: UPX is not available.
209 INFO: Extending PYTHONPATH with paths
['/Users/loretoparisi/Documents/Projects/AI/indic-trans',
 '/Users/loretoparisi/Documents/Projects/AI/indic-trans/indictrans']
210 INFO: checking Analysis
218 INFO: checking PYZ
223 INFO: checking PKG
224 INFO: Bootloader /Users/loretoparisi/Documents/Projects/AI/indic-trans/.venv/lib/python2.7/site-packages/PyInstaller/bootloader/Darwin-64bit/run
224 INFO: checking EXE
225 INFO: Rebuilding out00-EXE.toc because __init__ missing
225 INFO: Building EXE from out00-EXE.toc
225 INFO: Appending archive to EXE /Users/loretoparisi/Documents/Projects/AI/indic-trans/indictrans/dist/__init__
230 INFO: Fixing EXE for code signing /Users/loretoparisi/Documents/Projects/AI/indic-trans/indictrans/dist/__init__
234 INFO: Building EXE from out00-EXE.toc completed successfully.

但是当我运行它时，我得到一个导入错误

Traceback (most recent call last):
  File "indictrans/__init__.py", line 9, in <module>
ValueError: Attempted relative import in non-package
[30629] Failed to execute script __init__

该库是使用 构建的赛通 通过 cythonize 设置，因此另一种选择是使用 --embed 构建可执行嵌入式模块Cython 选项。

我的 setup.py如下:

#!/usr/bin/env python

import os

from setuptools import setup
from setuptools.extension import Extension
from Cython.Build import cythonize

import numpy


os.environ['PBR_VERSION'] = '1.2.3'
os.environ['SKIP_WRITE_GIT_CHANGELOG'] = '1'
os.environ['SKIP_GENERATE_AUTHORS'] = '1'


extensions = [
    Extension(
        "indictrans._decode.beamsearch",
        [
            "indictrans/_decode/beamsearch.pyx"
        ],
        include_dirs=[numpy.get_include()]
    ),
    Extension(
        "indictrans._decode.viterbi",
        [
            "indictrans/_decode/viterbi.pyx"
        ],
        include_dirs=[numpy.get_include()]
    ),
    Extension(
        "indictrans._utils.ctranxn",
        [
            "indictrans/_utils/ctranxn.pyx"
        ],
        include_dirs=[numpy.get_include()]
    ),
    Extension(
        "indictrans._utils.sparseadd",
        [
            "indictrans/_utils/sparseadd.pyx"
        ],
        include_dirs=[numpy.get_include()]
    )

]

setup(
    setup_requires=['pbr'],
    pbr=True,
    ext_modules=cythonize(extensions)
)

虽然使用 --embed option 编译单个 python 文件很容易。 ，见 here关于这个，我不知道如何使用 --embed setup.py 中的选项为了摆脱项目中的所有依赖关系。

Answer 1

我将使用 setup.py 引用根包目录文件为 包目录，即indic-trans在你的情况下。我将第一级源目录称为 模块 目录，即indic-trans/indictrans在你的情况下。

如果我正确理解了您的设置，那么您会因为尝试创建 .exe 而遇到问题。在 中的脚本上模块 目录而不是 包目录。这使得当前目录成为内部模块目录，并且相对引用将不起作用。

我在类似情况下解决此问题的方法是创建一个 run.py主脚本 包目录(与 setup.py 相同的文件夹)导入包，然后运行您想要在 中运行的任何脚本模块 目录。

您没有发布 __init__.py文件(顺便说一句，在 __init.py__ 中包含任何真实代码通常是不受欢迎的)，所以我假设下面你要运行 main() base.py 中的函数脚本。在这种情况下，使 run.py就像是:

# This will import everything from the module __init__.py based on it's "all" setup
# You likely want to limit it to just what is needed or just the script you are targeting
# Or you can use the "import indictrans" format and let __init__.py handle it
from indictrans import * 

def main():
    indictrans.base.main()

if __name__ == '__main__':
    main()

现在您可以只运行 run.py从命令行或将其用作调试目标来运行您的包。

请注意，使用 PyInstaller，您可以定位 run.py (或 run.spec )并使用 --name 将名称更改为其他名称争论。

pyinstaller --onefile --name indictrans run.spec

这将创建 indictrans.exe在 dist目录。

将包作为模块运行

请注意，在 模块 目录，也可以创建一个 __main__.py基本上是 run.py 的副本的文件并且做同样的事情，但如果它是本地安装的，它将由 Python 可执行文件作为模块运行。

即 python -m indictrans将使用 __main__.py 运行您的包作为入口点。