api设计风格: 命令式/可链式/配置式

# 命令式api
for context in (gen := merge(({"old"}, {"new"}))):root = context.rootnode = context.nodeif context.diffType == "values_changed":merge.hook_forceImmutable(context.root, context.node)merge.hook_auto()else:# 可链式apimerge.hook_forceImmutable().hook_auto()# gen.send(NEW) # gen.send(None) 无法区分业务None与默认next()的底层None# TODO merge内部 有没有办法感知到 外部for循环内执行了任何命令？# 直接这样也行，走默认配置
merged = return_of(merge(({"old"}, {"new"})))# 可链式api
merged = (MergeBuilder(old, new).immutable(True).auto_for(set, "^,new-^,old-^")           # 或 .strategy(set, UnionStrategy(...)).hook("values_changed", hook_forceImmutable).hook("default", hook_auto).on_path("settings.*", override=True)     # path-specific.execute())                               # 或 .merge()# 声明式&配置式api
merged = merge(({"old"}, {"new"}),auto={set: "^,new-^,old-^"},hook={"values_changed": merge.hook_auto},
)

命令式

最灵活，但也考验库设计者的设计思路。
且使用者需要阅读文档才会使用。

Builder / Fluent / 链式 API

配置式的另类写法，链式执行

配置式

静态，但难以拓展灵活的需求