设置布尔选项（boolean_options）方法的实现–setuptools.command.setopt.option_base

在 setuptools 中，option_base 是一个基类，用于设置布尔选项。下面是 option_base 类的基本实现以及一个使用示例。

from distutils.errors import DistutilsOptionError
from setuptools import Command


class OptionBase:
    # 设置选项名称
    def __init__(self, name):
        self.name = name
        self.description = ''

    # 添加选项描述
    def set_description(self, description):
        self.description = description

    # 检查输入的选项值是否为合法的布尔值
    def check_boolean(self, value):
        if value.lower() not in ['true', 'false']:
            raise DistutilsOptionError(f"Invalid value for {self.name}: {value}. Must be either 'true' or 'false'.")

    # 获取选项的默认值
    def get_default(self):
        return False

    # 从命令行获取选项值
    def from_command_line(self, cmd_options):
        return cmd_options.get(self.name, None)

    # 将选项值设置为 True
    def set_value(self, dist):
        setattr(dist, self.name, True)

    # 将选项值设置为默认值
    def set_default(self, dist):
        setattr(dist, self.name, self.get_default())

    # 输出选项的帮助文档
    def get_help(self):
        return f"--{self.name}: {self.description}"


class CommandWithBooleanOptions(Command):
    user_options = [
        ('my-bool-option=', None, 'A boolean option.'),
    ]

    def initialize_options(self):
        self.my_bool_option = None

    def finalize_options(self):
        if self.my_bool_option is None:
            self.my_bool_option = self.get_finalized_command('build').bool_option

    def run(self):
        print(f"My bool option value: {self.my_bool_option}")


class MyBoolOption(OptionBase):
    def __init__(self):
        super().__init__('my_bool_option')
        self.set_description('This is a boolean option.')

    def from_command_line(self, cmd_options):
        value = super().from_command_line(cmd_options)
        if value is not None:
            self.check_boolean(value)
        return value == 'True'


# 使用示例
if __name__ == '__main__':
    bool_option = MyBoolOption()

    command = CommandWithBooleanOptions()
    command.my_bool_option = True

    assert bool_option.from_command_line(command.my_bool_option) is True
    assert bool_option.from_command_line({}) is None

    command.run()

在这个示例中，我们创建了一个名为 MyBoolOption 的自定义布尔选项类，它继承自 OptionBase。我们还创建了一个 CommandWithBooleanOptions 类，它继承自 Command。CommandWithBooleanOptions 类包含了一个布尔选项 my-bool-option。

在 MyBoolOption 中，我们通过重写一些方法来自定义布尔选项的行为。在 from_command_line 方法中，我们检查了从命令行传入的选项值是否为合法的布尔值。在 initialize_options 方法中，我们将选项的默认值设置为 None。这样，如果用户没有在命令行中指定该选项，它将使用 CommandWithBooleanOptions 类中的默认值（即 build 命令的布尔选项）。

在 CommandWithBooleanOptions 中，我们重写了 finalize_options 方法来获取其他命令的布尔选项的最终值。然后，我们在 run 方法中打印出布尔选项的值。

在使用示例中，我们实例化了 MyBoolOption 和 CommandWithBooleanOptions 类，并设置了 my-bool-option 为 True。然后，我们通过调用 from_command_line 方法来获取从命令行传入的选项值，并打印出该值。

以上就是使用 setuptools.command.setopt.option_base 来设置布尔选项的方法实现及使用示例。通过继承和重写方法，我们可以自定义布尔选项的行为，以满足不同的需求。