允许在方法签名包含显式return_attrs arg时返回所有属性的惯用法

Question

我正在为SOAP API构建一个Python包装器。 SOAP模式使用list方法的以下公共签名定义方法：

ListObjectReq(searchCriteria, returnedTags)

API要求客户端显式定义要返回的端点的所有属性。这是痛苦的并且对用户来说是麻烦的。我希望用一个选项来包装它，以便在需要时返回给定方法调用的所有属性。

我的问题是，最蟒蛇的方式是什么？我会简单地允许：

1. 通过str "all"：

   object.list（search_criteria = search_criteria，returned_tags =“all”）

2. 传递all功能：

   object.list（search_criteria = search_criteria，returned_tags = all）

3. 将returned_tags设为kwarg，然后添加其他kwarg选项return_all。

   object.list（search_criteria = search_criteria，return_all = True）

   如果是这样，在提供两种情况时，内部处理案例的最佳方法是什么？

   • 如果提供了returned_tags，请忽略return_all
   • 提出错误returned_tags并提供return_all=True？

我可能正在沸腾海洋，但我正在寻找处理这些类型情况的认真接近。