校验布尔环境变量取值

[ghangz]

该 PR 对布尔型环境变量增加合法值校验，避免拼写错误静默落入默认行为，提升推理部署时的可观测性。

这个修改面向沐曦 GPU 适配场景中比较容易影响开发、构建或验证稳定性的环节，把原来需要人工排查的问题前移到工具链、运行前检查或基准脚本中处理。实现上保持对现有默认行为的兼容，只在检测到明确配置、输入或环境异常时给出更直接的诊断，避免引入额外运行依赖，也方便维护者独立审阅该分支。

已在沐曦算力环境中完成对应分支验证，验证记录包含真实运行日志、命令输出和失败路径检查，本地归档目录为：E:/Documents/muxi/测试报告/vLLM-metax_real_env_validation_20260608。提交分支：mengz/validate-bool-env-values，目标仓库：MetaX-MACA/vLLM-metax。

[gemini-code-assist]

Code Review

This pull request introduces a helper function _parse_bool_env in vllm_metax/envs.py to validate and parse boolean environment variables, refactoring several environment variable definitions to use it. It also adds a new test file tests/test_env_bool_parser.py. The reviewer noted that using ast and exec to dynamically load the helper function in the tests is overly complex and fragile, and recommended importing the function directly instead.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

问题描述

使用 ast 解析源码并用 exec 动态加载 _parse_bool_env 函数的设计过于复杂且非常脆弱。这种做法存在以下问题：

1. 脆弱性高：如果 vllm_metax/envs.py 的导入方式发生变化（例如改为 from os import getenv），或者添加了其他模块级依赖，该测试将会因为找不到 os 导入或模块未完全加载而直接崩溃。
2. 维护成本高：使用 AST 解析和 exec 使得代码难以阅读和维护，不符合 Python 的简洁和直观设计原则。

解决方案

由于 vllm_metax/envs.py 在导入时没有副作用，因此可以直接通过标准的 Python import 语句导入 _parse_bool_env 进行测试。这样不仅能极大简化测试代码，还能提高测试的健壮性和可维护性。

如果需要支持直接运行该脚本而不需要配置 PYTHONPATH，可以在脚本开头动态将项目根目录添加到 sys.path 中。

import os
import sys
from pathlib import Path
from unittest.mock import patch

# 将项目根目录添加到 sys.path 以支持直接运行脚本
sys.path.append(str(Path(__file__).resolve().parents[1]))

from vllm_metax.envs import _parse_bool_env


def test_bool_parser_accepts_zero_and_one():
    with patch.dict(os.environ, {"FLAG": "1"}, clear=True):
        assert _parse_bool_env("FLAG", "0") is True
    with patch.dict(os.environ, {"FLAG": "0"}, clear=True):
        assert _parse_bool_env("FLAG", "1") is False


def test_bool_parser_reports_variable_name():
    with patch.dict(os.environ, {"FLAG": "yes"}, clear=True):
        try:
            _parse_bool_env("FLAG", "0")
        except ValueError as err:
            assert "FLAG" in str(err)
            assert "0 or 1" in str(err)
        else:
            raise AssertionError("expected ValueError")


if __name__ == "__main__":
    test_bool_parser_accepts_zero_and_one()
    test_bool_parser_reports_variable_name()