使用Python的distutils库中的build_scripts模块的first_line_re函数生成脚本的首行注释示例

distutils库是Python的一个标准库，用于构建、打包和分发Python模块。其中的build_scripts模块提供了一些函数和类，用于生成可执行脚本。

在build_scripts模块中，有一个名为first_line_re的函数，用于生成脚本的首行注释。下面是first_line_re函数的使用说明和示例：

使用说明：

def first_line_re(script_text):
    """
    Given the text of the script, return the text of the first line,
    modified as appropriate.  Currently, this is done by removing a
    shebang line or decoding an encoding declaration.

    :param script_text: the text of the script
    :returns: the modified text of the first line
    :raises SyntaxError: if the first line is not a valid Python
                         statement
    """

示例：

import distutils.build_scripts

script_text = "#!/usr/bin/env python

print('Hello, world!')
"
first_line = distutils.build_scripts.first_line_re(script_text)
print(first_line)

# Output:
# "#!/usr/bin/env python"

在上面的示例中，我们传递了一个脚本文本给first_line_re函数，并打印了返回的首行注释。

需要注意的是，first_line_re函数会检查并处理脚本的首行注释。如果脚本的首行是一个shebang行（以#!开头），则会返回去除了shebang行的注释部分。如果脚本的首行是一个编码声明（以coding:开头），则会返回去除了编码声明的注释部分。如果首行既不是shebang行也不是编码声明，则会引发SyntaxError异常。

这里给出的示例只是first_line_re函数的基本用法，distutils库还提供了其他一些有用的函数和类，可用于更复杂的脚本构建任务。