"""DataFrame 共用工具 — 跨 routes/services 共享。"""


def find_col(df_cols, keywords):
    """從欄位列表中，根據關鍵字列表找出最匹配的欄位名稱。

    Args:
        df_cols: DataFrame 的欄位名稱 iterable
        keywords: 關鍵字列表，依優先序

    Returns:
        匹配的欄位名稱字串，找不到則回傳 None
    """
    for k in keywords:
        for col in df_cols:
            if k in str(col):
                return col
    return None