Dotenv(.env)解析

script_vars.load_vars_from_json 可載入扁平 JSON,但沒有任何東西讀取 de-facto 12-factor 的 .env 檔案。本功能把 KEY=VALUE 行 —— 遵循 export 前綴、單/雙引號、轉義與行內註解 —— 解析成可餵給設定層的純 dict,且不依賴 python-dotenv。

純標準函式庫(re);不匯入 PySide6。parse_dotenv 為純字串轉 dict 函式,載入器會合併進 呼叫端提供的 mapping 而非變動 os.environ,因此安全且具決定性。

無頭 API

from je_auto_control import parse_dotenv, load_dotenv, dotenv_values, dump_dotenv

values = parse_dotenv('PLAIN=hello\nexport TOKEN="a\\nb"  # comment')
# {"PLAIN": "hello", "TOKEN": "a\nb"}

config = {}
load_dotenv(".env", config)                 # 把檔案合併進 dict
load_dotenv(".env.local", config, override=True)

parse_dotenv 略過空白與 # 註解行,去除選用的 export 前綴,驗證鍵,並解析值:單引號值為 字面值,雙引號值處理 \n / \t / \\ / \" 轉義,未加引號的值會去除結尾 `` #`` 註解與 前後空白。dotenv_values 讀取並解析檔案;``load_dotenv`` 把檔案合併進明確的 env mapping (預設保留既有鍵,除非 override);``dump_dotenv`` 把 mapping 序列化回 .env 文字,並為需要的值 加上引號。

執行器命令

AC_parse_dotenv 把 text 解析成 {values};``AC_load_dotenv`` 從 path 讀檔載入到新的 {values} dict。兩者皆以 MCP 工具(ac_parse_dotenv / ac_load_dotenv)以及 Script Builder 中 Data 分類下的命令提供。