如何为具有多个命令组的控制台脚本设置 Python 单击的入口点

Question

鉴于我的库是这样设置的foobar.py：

foobar.py
foobar
    __init__.py
setup.py

控制台脚本中 CLI 的层次结构：

foobar.py
    cli
         foo
             kungfu
             kungpow
         bar
             blacksheep
             haveyouanywool

[代码]：

import click
CONTEXT_SETTINGS = dict(help_option_names=['-h', '--help'])

@click.group()
@click.version_option()
def cli():
    pass
@cli.group(context_settings=CONTEXT_SETTINGS)
def foo():
    pass
@cli.group(context_settings=CONTEXT_SETTINGS)
def bar():
    pass
@foo.command('kungfu')
def kungfu():
    print('bruise lee')
@foo.command('kungpow')
def kungpow():
    print('chosen one')
@bar.command('blacksheep')
def blacksheep():
    print('bah bah blacksheep')
@bar.command('haveyouanywool')
def haveyouanywool():
    print('have you any wool?')

我应该如何在setup.py中设置我的条目？

有很多例子，但它们只显示单个入口点的单个命令，例如 setup.py 中的入口点

但是，是否可以使用我的foobar.py单击脚本的结构来设置控制台脚本？

如果没有，我应该如何重组foobar.py中的命令？

---

对于上下文，我有sacremoses库的脚本：https://github.com/alvations/sacremoses/blob/cli/sacremoses.py

但是我不知道如何配置setup.py以正确安装 sacremoses.py 脚本：https://github.com/alvations/sacremoses/blob/cli/setup.py

Answer 1

要使入口点在您的示例中起作用，您需要：

entry_points='''
    [console_scripts]
    command_line_name=foobar:cli
''',

你缺少的是对以下含义的理解：

command_line_name=foobar:cli

[console_scripts]

command_line_name=foobar:cli有三件事：

1. 命令行中的脚本名称 （ command_line_name ）
2. 单击命令处理程序所在的模块 （ foobar ）
3. 该模块中的单击命令/组的名称 （ cli ）

setup.py

对于您的github示例，我建议：

from distutils.core import setup
import setuptools
console_scripts = """
[console_scripts]
sacremoses=sacremoses.cli:cli
"""
setup(
    name='sacremoses',
    packages=['sacremoses'],
    version='0.0.7',
    description='SacreMoses',
    long_description='LGPL MosesTokenizer in Python',
    author='',
    license='',
    package_data={'sacremoses': [
        'data/perluniprops/*.txt', 
        'data/nonbreaking_prefixes/nonbreaking_prefix.*'
    ]},
    url='https://github.com/alvations/sacremoses',
    keywords=[],
    classifiers=[],
    install_requires=['six', 'click', 'joblib', 'tqdm'],
    entry_points=console_scripts,
)

命令处理程序

在 github 存储库的引用分支中，没有 cli.py 文件。 您问题中的[代码]需要保存在sacremoses/cli.py中，然后与建议的 setup.py 更改相结合，一切应该都可以正常工作。