python - モジュールのバージョン番号を公開するための推奨される方法は何ですか?

Question

モジュールのバージョン番号を公開するための推奨される方法は何ですか?

• Python 自体は組み込みタプルを使用しますsys.version_info。

  >>> sys.version_info
  sys.version_info(major=3, minor=3, micro=0, releaselevel='final', serial=0)
  

• MySQLdb (たとえば) は通常のタプルを使用します。

  >>> MySQLdb.version_info
  (1, 2, 3, 'final', 0)
  

• 一部のサードパーティ ライブラリは文字列を使用します__version__

  >>> requests.__version__
  '1.2.3'
  

• 一部のフレームワークはタプルを使用しますVERSION:

  >>> django.VERSION
  (1, 6, 0, 'alpha', 0)
  

…どうやら、その件には色々な使い方があるらしい！

Answer 1

PEP 396によると、それはmodule.__version__. その PEP によると、PEP 386のNormalized Versionスタイルを使用して、どのように記述すべきかを決定する必要があります。

386 に取って代わるPEP 440のドラフト バージョンがあるようです。