公开模块版本号的首选方法是什么？

Question

什么是/是否有一种首选方式来公开模块版本号？

• Python本身使用builtins元组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中的规范化版本样式来决定如何编写它.

看起来有一个PEP 440的草稿版本将取代386.