setup.py 中 entry_points/console_scripts 和脚本之间的区别？

Question

基本上有两种方法可以通过setup.py将Python控制台脚本安装到我的路径：

setup(
    ...
    entry_points = {
        'console_scripts': [
            'foo = package.module:func',
        ],
    }
)

和

setup(
    ...
    scripts = [
        'scripts/myscript.sh'
    ]
)

有什么区别？我看到第一种方法允许我为我的脚本选择好的、特定的名称，但还有其他区别吗？不同的原始用途、兼容性（setuptools、distutils、...？）、用法、...？我很困惑，一个详细的回答可以帮助我（可能还有其他人）正确理解这一切。

更新：自从我问了PyPA 发布的these cool docs on the topic 的问题。

Answer 1

这两种创建命令行可执行文件的方法之间的一个关键区别是，使用setuptools 方法（您的第一个示例），您必须在脚本内部调用一个函数——在您的情况下，这是func在您的module 内。但是，在 distutils 方法（您的第二个示例）中，您可以直接调用脚本（允许在有或没有扩展名的情况下列出）。

Answer 2

设置工具入口点方法 (#1) 还具有the benefit，在 Windows 上将创建一个 .exe，可以像常规 Windows 程序一样双击和调用。这是在类 posix 系统上将脚本放置在 bin 路径中的补充。

Answer 3

（很棒的）Click 包 suggest a few reasons 的文档使用入口点而不是脚本，包括

1. 跨平台兼容性和
2. 避免让解释器将 __name__ 分配给 __main__，这可能会导致代码被导入两次（如果另一个模块导入您的脚本）

Click 是一种很好的方式来实现用作entry_points 的函数，顺便说一句。

Answer 4

另一个区别是，当使用 console_scripts 时，我的模块的 __init__ 文件被运行。只使用脚本时，模块__init__没有运行，只运行了脚本。