问题描述
通过 setup.py 将 Python 控制台脚本安装到我的路径中基本上有两种方法:
There are basically two ways to install Python console scripts to my path by setup.py:
setup( ... entry_points = { 'console_scripts': [ 'foo = package.module:func', ], } )
和
setup( ... scripts = [ 'scripts/myscript.sh' ] )
有什么区别?我看到第一种方法允许我为我的脚本选择好的、特定的名称,但是还有其他区别吗?不同的原始用途、兼容性(setuptools、distutils、...?)、用法、...?我很困惑,一个很好的详细回复可以帮助我(可能还有其他人)正确理解这一切.
What are the differences? I see the first approach allows me to choose nice, specific name for my script, but are there any other differences? Different original purposes, compatibility (setuptools, distutils, ...?), usage, ...? I am quite confused and a nice elaborated reply could help me (and probably also others) to properly understand all this.
更新:自从我提出问题 PyPA 发布 这些关于该主题的酷文档.
Update: Since I asked the question PyPA published these cool docs on the topic.
推荐答案
(很棒的)Click 包的文档 建议几个理由 使用入口点而不是脚本,包括
The docs for the (awesome) Click package suggest a few reasons to use entry points instead of scripts, including
- 跨平台兼容性和
- 避免让解释器将 __name__ 分配给 __main__,这可能导致代码被导入两次(如果另一个模块导入您的脚本)
- cross-platform compatibility and
- avoiding having the interpreter assign __name__ to __main__, which could cause code to be imported twice (if another module imports your script)
Click 是实现函数的好方法,可用作 entry_points,顺便说一句.
Click is a nice way to implement functions for use as entry_points, btw.