如何在argparse中仅对带'm'后缀的参数值触发弃用警告

你遇到的核心问题是在argparse的type函数内触发警告时被当成致命错误，这是因为原代码没有正确使用Python的警告系统，而是直接将警告类作为日志参数传递，导致环境将其识别为错误。下面是两种可行的解决方案：

方案一：使用标准警告模块触发弃用警告 #

修改你的str_to_bar函数，改用warnings.warn()来触发弃用警告，这是Python的标准做法，不会被argparse视为致命错误：

import warnings
from decimal import Decimal
import structlog

def str_to_bar(value: str) -> Decimal:
    number_value = value.removesuffix("m")
    if number_value != value:
        warning_msg = (
            "Specifying bar with a trailing 'm' character will not be supported in future versions. "
            "Please use a plain decimal number like '0.3' instead."
        )
        # 触发标准弃用警告
        warnings.warn(warning_msg, DeprecationWarning, stacklevel=2)
        # 同时用structlog记录日志（可选）
        structlog.get_logger().warning(warning_msg)
    
    return Decimal(number_value)

将这个函数作为type参数传给argparse的add_argument即可，当用户传入1m时会正常触发警告，传入1则无提示。

方案二：解析后再处理参数（更稳妥） #

如果环境对警告的限制比较严格，可以先让argparse将参数解析为字符串，在解析完成后再处理转换和警告逻辑：

import argparse
from decimal import Decimal
import warnings
import structlog

# 初始化解析器，将bar参数设为字符串类型
parser = argparse.ArgumentParser()
parser.add_argument("--bar", type=str, required=True)
args = parser.parse_args()

# 处理bar参数的转换和警告
bar_str = args.bar
number_value = bar_str.removesuffix("m")
if number_value != bar_str:
    warning_msg = (
        "Specifying bar with a trailing 'm' character will not be supported in future versions. "
        "Please use a plain decimal number like '0.3' instead."
    )
    warnings.warn(warning_msg, DeprecationWarning, stacklevel=2)
    structlog.get_logger().warning(warning_msg)

# 转换为Decimal类型，处理无效输入
try:
    args.bar = Decimal(number_value)
except ValueError:
    parser.error(f"Invalid value for --bar: {bar_str}")

这种方式完全避开了argparse对type函数内警告的处理逻辑，兼容性更好。

原方案失效原因 #

你之前的代码将DeprecationWarning类作为参数传给structlog.warning，这不是触发Python警告系统的正确方式。如果你的运行环境设置了警告过滤器（比如-Werror），会将此类警告直接转为致命错误，导致程序崩溃。使用标准的warnings.warn()可以让警告按预期触发，且默认不会中断程序运行。

内容的提问来源于stack exchange，提问作者l0b0