関数引数の処理に推奨されるPythonモジュール？

Question

コマンドラインオプション（argparse、getopt、blargsなど）の解析と調整には、多くのPythonモジュールがあります。そして、Pythonは様々な関数の引数（例えば、デフォルト値、* varargs、** keyword_args）を扱うための優れた組み込みの機能/イディオムに恵まれています。しかし、トップレベル関数のためのさまざまなプロジェクトのコードを読んだとき、私はコマンドライン引数よりも関数引数の規律と標準化が顕著に少なくなっています。

単純な関数の場合、これは問題ではありません。ビルトインの引数の機能は十分に機能しています。しかし、トップレベルの機能がさまざまな引数とオプション（補完的または排他的なもの）、さまざまな操作モード、デフォルト、オーバーライドなどを多数提供する機能豊富なモジュールが数多くあります。つまり、引数の複雑さがありますコマンドライン引数のそれに近づく。そして、彼らは主に彼らの議論をアドホック方法で扱っているようです。

コマンドライン処理モジュールの数が増え、時間が経ってどのように洗練されたのかを考えれば、複雑な関数引数の論争を単純化するために少なくとも少数のモジュールが必要になると思います。しかし、私はPyPi、stackoverflow、Googleを検索して成功していません。だから...あなたが推奨する引数を扱う引数（コマンドラインではありません）がありますか？

---例で更新---

あなたは洗練されたモジュールを扱っているまで、ユースケースが表示されないので、それは本当に簡単な具体例を与えることは難しいです。しかし、ここではコードの問題を説明しています：フォーマッタのインスタンス化でオーバーライドできるデフォルトのフォーマッタモジュール、または関数/メソッドが呼び出されたとき。ほんの僅かなオプションしか持たないので、すでにオプション処理の言葉が大量にあり、オプション名はad nauseamと繰り返されます。

defaults = { 'indent':  4, 
       'prefix': None, 
       'suffix': None, 
       'name':  'aFormatter', 
       'reverse': False, 
       'show_name': False 
      } 

class Formatter(object): 

    def __init__(self, **kwargs): 
     self.name = kwargs.get('name', defaults['name']) 
     self.indent = kwargs.get('indent', defaults['indent']) 
     self.prefix = kwargs.get('prefix', defaults['prefix']) 
     self.suffix = kwargs.get('suffix', defaults['suffix']) 
     self.reverse = kwargs.get('reverse', defaults['reverse']) 
     self.show_name = kwargs.get('show_name', defaults['show_name']) 

    def show_lower(self, *args, **kwargs): 
     indent = kwargs.get('indent', self.indent) or 0 
     prefix = kwargs.get('prefix', self.prefix) 
     suffix = kwargs.get('suffix', self.suffix) 
     reverse = kwargs.get('reverse', self.reverse) 
     show_name = kwargs.get('show_name', self.show_name) 

     strings = [] 
     if show_name: 
      strings.append(self.name + ": ") 
     if indent: 
      strings.append(" " * indent) 
     if prefix: 
      strings.append(prefix) 
     for a in args: 
      strings.append(a.upper() if reverse else a.lower()) 
     if suffix: 
      strings.append(suffix) 
     print ''.join(strings) 

if __name__ == '__main__': 
    fmt = Formatter() 
    fmt.show_lower("THIS IS GOOD") 
    fmt.show_lower("THIS", "IS", "GOOD") 
    fmt.show_lower('this IS good', reverse=True) 
    fmt.show_lower("something!", show_name=True) 

    upper = Formatter(reverse=True) 
    upper.show_lower("this is good!") 
    upper.show_lower("and so is this!", reverse=False) 

Answer 1

あなたのAPIは、あなたがあなたを渡されたオプションを処理するためにいくつかのモジュールを使用する方が簡単だと思うので、複雑な場合は、実際ソリューションは、あなたのAPIを簡単にすることである可能性が高いと言えます。いくつかのモジュールが非常に複雑なものを呼び出す方法を持っているという事実は、機能ではなく、残念です。

私が最初にあなたの質問を読ん

Answer 2

は、私はあなたがバンドエイドモジュールを求め、そして誰もが悪いデザインが持続することができますモジュールを書きたいとは思いませんので、それが存在しないことをしていることを自分自身に考えました。

しかし、私は状況がそれより複雑であることに気付きました。あなたが記述するモジュールの作成のポイントは、再利用可能な一般的なコードを作成することです。さて、正当な理由で複雑なインターフェースがいくつかあるかもしれません。しかし、これらのインターフェイスは、正確にはです。これはおそらく一般的なケースのコードでは簡単に処理できません。彼らは特殊なケースがたくさんある問題のあるドメインに対処するため、複雑です。

つまり、インターフェイスが実際にをリファクタリングできない場合、おそらくモジュールで一般化する価値があるほど予測できないカスタムの特殊ケースコードがたくさん必要になるでしょう。インターフェースは簡単にあなたが記述の種類のモジュールにパッチを適用できるのであれば逆に、おそらくリファクタリングすることができます - その場合にはそれがあるべき。

Answer 3

開発者の手でその、しかし、あなたには、いくつかの他のプロジェクトのために有用である可能性があるか、他のユーザー間で公開されますライブラリを作っているなら、私はあなたの問題を特定し、それを分析する必要が最初だと思う、

あなたの関数をうまく記述してください。引数の数を最小限に抑えれば、ユーザが渡す必要があるものを指定するのが難しい関数引数のデフォルト値を提供します。

classmethods特別な場合は、高度なプログラミングのために上書きすることも、実際にライブラリで再生していることを達成したい上級ユーザーが提供することもできます。継承は常に存在します。

、あなたは役に立つかもしれませんが、最終的な目標はオプションの引数にデフォルト値を提供することをいい、必要な引数を入力するユーザーを制限、引数の最小数を指定することでもPEP8読むことができます - あなたのlibrary方法での/ codeは普通の開発者でも簡単に理解できます。

Answer 4

デフォルトのコードをもっと書くことができます。

他の方法でデフォルトにすることを考えるなら、デフォルトを通り、存在しない場合はキーワードを上書きしてください。

defaults = { 'indent':  4, 
      'prefix': None, 
      'suffix': None, 
      'name':  'aFormatter', 
      'reverse': False, 
      'show_name': False 
     } 

class Formatter(object): 

    def __init__(self, **kwargs): 
     for d,dv in defaults.iteritems(): 
     kwargs[d] = kwargs.get(d, dv) 

側注： 私は、デフォルトで__init__メソッド定義にキーワード引数を使用してお勧めします。これはfunction定義は、本当に私は、コマンドラインの解析と関数の引数の処理は多くの共通点を持っていないと思うあなたのクラスの他の開発者とユーザ（Formatter）

def __init__(self, indent=4, reverse=False .....etc.....): 

Answer 5

1. との契約になることができます。コマンドラインの主な問題は、利用可能なデータ構造だけが文字列のフラットなリストであり、各文字列が何を意味するかを定義するために使用できる関数ヘッダーのような計測器がないことです。 Python関数のヘッダーでは、各パラメーターに名前を付けることができます。パラメーターとしてコンテナーを受け入れることも、デフォルトの引数値を定義することもできます。コマンドライン解析ライブラリは、機能Pythonは関数呼び出しのための関数を提供しています：名前をパラメータに渡し、デフォルト値を代入し、必要な型に変換します。Pythonでは、これらのすべての機能が組み込まれているので、ライブラリを必要としません。

2. この例では、言語が提供する機能を使用してこのデザインを改善する方法が数多くあります。 defaults辞書の代わりにデフォルトの引数値を使うことができます。すべてのフラグをFormatterConfigクラスにカプセル化し、これらの引数のすべてではなく1つの引数だけを渡すことができます。しかし、あなたが例のコードで与えたインタフェースを正確に欲しいと仮定しましょう。これを実現する1つの方法は次のコードです：

   class Config(dict): 
       def __init__(self, config): 
        dict.__init__(self, config) 
        self.__dict__ = self 
   
   def get_config(kwargs, defaults): 
       config = defaults.copy() 
       config.update(kwargs) 
       return Config(config) 
   
   class Formatter(object): 
   
       def __init__(self, **kwargs): 
        self.config = get_config(kwargs, defaults) 
   
       def show_lower(self, *args, **kwargs): 
        config = get_config(kwargs, self.config) 
   
        strings = [] 
        if config.show_name: 
         strings.append(config.name + ": ") 
        strings.append(" " * config.indent) 
        if config.prefix: 
         strings.append(config.prefix) 
        for a in args: 
         strings.append(a.upper() if config.reverse else a.lower()) 
        if config.suffix: 
         strings.append(config.suffix) 
        print "".join(strings) 
   

   Pythonはこの種の引数処理を行うツールを多数提供しています。したがって、（デフォルトの引数のように）それらのいくつかを使用しないことを決めたとしても、やり直しを避けることができます。