给下面的代码写上注释from invoke import task @task def build_docs(context): context.run("aizynthcli -h > ./docs/cli_help.txt") context.run("sphinx-apidoc -o ./docs ./aizynthfinder") context.run("sphinx-build -M html ./docs ./docs/build") @task def full_tests(context): cmd = ( "pytest --black --mccabe " "--cov aizynthfinder --cov-branch --cov-report html:coverage --cov-report xml " "tests/" ) context.run(cmd) @task def run_mypy(context): context.run("mypy --ignore-missing-imports --show-error-codes aizynthfinder") @task def run_linting(context): print("Running mypy...") context.run("mypy --install-types", pty=True) context.run( "mypy --ignore-missing-imports --show-error-codes --implicit-optional aizynthfinder" ) print("Running pylint...") context.run("pylint aizynthfinder")

下面是给代码添加注释的示例：

from invoke import task

@task
def build_docs(context):
    # 生成命令行帮助文档
    context.run("aizynthcli -h > ./docs/cli_help.txt")

    # 生成API文档
    context.run("sphinx-apidoc -o ./docs ./aizynthfinder")

    # 构建文档
    context.run("sphinx-build -M html ./docs ./docs/build")

@task
def full_tests(context):
    # 运行完整测试套件，包括代码格式检查和代码覆盖率检查
    cmd = (
        "pytest --black --mccabe "
        "--cov aizynthfinder --cov-branch --cov-report html:coverage --cov-report xml "
        "tests/"
    )
    context.run(cmd)

@task
def run_mypy(context):
    # 运行mypy类型检查，忽略缺失的导入和显示错误码
    context.run("mypy --ignore-missing-imports --show-error-codes aizynthfinder")

@task
def run_linting(context):
    print("Running mypy...")
    # 运行mypy类型检查，安装类型信息并显示错误码
    context.run("mypy --install-types", pty=True)

    # 运行mypy类型检查，忽略缺失的导入、显示错误码和隐式可选类型
    context.run(
        "mypy --ignore-missing-imports --show-error-codes --implicit-optional aizynthfinder"
    )

    print("Running pylint...")
    # 运行pylint代码静态分析工具
    context.run("pylint aizynthfinder")

这些注释描述了每个任务函数的功能和用途，以及在每个任务函数中执行的具体操作。这样有助于提高代码的可读性和可理解性，并使其他开发人员更容易理解代码的意图和目的。