发布方使用Entry Points(入口点)向使用方介绍包中的Python对象,例如函数和类。可扩展的应用和框架通过名字或组(name or group)在特定的包中或者系统路径中能够访问到的包中查询入口点,然后按照入口点的描述来观察和加载这个Python对象。
入口点隶属于某个组,这个组的命名规则是XXX.XXX的形式。例如setuptools包中有一个组名是distutils.commands的入口点,通过这个组名能够找到distutils扩展中定义的命令。setuptools中的安装脚本将distutils.commands这个组中入口点的名字作为命令来使用。
这个组中入口点的名字可以是动态的,也可以是预先定义的名字。例如blogging框架提供了pre- 或 post-这样的钩子,相应的就会定义“pre_process”和“post_process”这样的入口点名字。
为了对外公布入口点,一个项目需要使用setuptools包,并在安装脚本的setup()函数中提供entry_points参数。这样,入口点将包含在包的元数据中。
一个组中的入口点名字必须唯一。例如distutils扩展能够公布两个不同的distutils.commands入口点组,只要入口点组用不同的名字。
假如引用的两个包中存在相同的入口点,那就需要应用或者框架去决定使用哪一个入口点,比如使用在sys.path中第一个搜索到的包中的入口点。