"入口点"通常是Python包的开发人员或用户可能想要使用的函数(或其他可调用的函数,如对象),尽管不可调用的对象也可以作为入口点提供(在注释中正确指出!).
最流行的入口点是console_scripts
入口点,它指向一个函数,您希望将该函数作为命令行工具提供给安装您的软件包的任何人.这将包含在您的setup.py
脚本中,如下所示:
entry_points={
'console_scripts': [
'cursive = cursive.tools.cmd:cursive_command',
],
},
我刚刚部署了一个名为cursive.tools
的包,我希望它能提供一个"草书"命令,有人可以从命令行运行,比如:
$ cursive --help
usage: cursive ...
要做到这一点,可以定义一个函数,比如文件cursive/tools/cmd.py
中的cursive_command
函数,如下所示:
def cursive_command():
args = sys.argv[1:]
if len(args) < 1:
print "usage: ..."
等等它应该假设它是从命令行调用的,解析用户提供的参数,然后...好吧,按命令的目的go 做.
安装docutils
软件包是入门点使用的一个很好的例子:它将安装六个有用的命令,用于将Python文档转换为其他格式.