快速開始

JSON 動作清單

動作可採用三種形狀之一：

["FA_name"]
["FA_name", {"kwarg": "value"}]
["FA_name", ["positional", "args"]]

動作清單是動作的陣列。執行器依序執行並回傳 "execute[<index>]: <action>" -> result | repr(error) 的對應表。

from automation_file import execute_action, read_action_json

results = execute_action([
    ["FA_create_dir", {"dir_path": "build"}],
    ["FA_create_file", {"file_path": "build/hello.txt", "content": "hi"}],
    ["FA_zip_dir", {"dir_we_want_to_zip": "build", "zip_name": "build_snapshot"}],
])

# 或從檔案載入：
results = execute_action(read_action_json("actions.json"))

驗證、dry-run、平行執行

from automation_file import (
    execute_action, execute_action_parallel, validate_action,
)

# Fail-fast 驗證：若有未知名稱，執行前即中止整批。
execute_action(actions, validate_first=True)

# Dry-run：記錄將呼叫什麼但不實際呼叫。
execute_action(actions, dry_run=True)

# 平行：透過執行緒池執行彼此獨立的動作。
execute_action_parallel(actions, max_workers=4)

# 手動驗證——回傳已解析的名稱清單。
names = validate_action(actions)

註冊自訂動作

from automation_file import add_command_to_executor, execute_action

def greet(name: str) -> str:
    return f"hello {name}"

add_command_to_executor({"greet": greet})
execute_action([["greet", {"name": "world"}]])

進入點打包與動態套件註冊請見 外掛與動態註冊。