最好的python库_什么是最好的Python库模块框架代码？

许多python IDE将启动一个模板&＃xff0c;如&＃xff1a;

print &＃39;hello world&＃39;

这还不够…所以这里是我的骨架代码来开始这个问题&＃xff1a;

我的模块骷髅&＃xff0c;短版本&＃xff1a;

#!/usr/bin/env python

"""

Module Docstring

"""

#

## Code goes here.

#

def test():

"""Testing Docstring"""

pass

if __name__&＃61;&＃61;&＃39;__main__&＃39;:

test()

和&＃xff0c;

我的模块骨架&＃xff0c;长版本&＃xff1a;

#!/usr/bin/env python

# -*- coding: ascii -*-

"""

Module Docstring

Docstrings: http://www.python.org/dev/peps/pep-0257/

"""

__author__ &＃61; &＃39;Joe Author (joe.author&＃64;website.org)&＃39;

__copyright__ &＃61; &＃39;Copyright (c) 2009-2010 Joe Author&＃39;

__license__ &＃61; &＃39;New-style BSD&＃39;

__vcs_id__ &＃61; &＃39;$Id$&＃39;

__version__ &＃61; &＃39;1.2.3&＃39; #Versioning: http://www.python.org/dev/peps/pep-0386/

#

## Code goes here.

#

def test():

""" Testing Docstring"""

pass

if __name__&＃61;&＃61;&＃39;__main__&＃39;:

test()

"""

&＃61;&＃61;&＃61;MODULE TYPE&＃61;&＃61;&＃61;

Since the vast majority of my modules are "library" types, I have constructed

this example skeleton as such. For modules that act as the main entry for

running the full application, you would make changes such as running a main()

function instead of the test() function in __main__.

&＃61;&＃61;&＃61;VERSIONING&＃61;&＃61;&＃61;

The following practice, specified in PEP 8, no longer makes sense:

__version__ &＃61; &＃39;$Revision: 1.2.3 $&＃39;

For two reasons:

(1) Distributed version control systems make it neccessary to include more

than just a revision number. E.g. author name and revision number.

(2) It&＃39;s a revision number not a version number.

Instead, the __vcs_id__ variable is being adopted. This expands to, for

example:

__vcs_id__ &＃61; &＃39;$Id: example.py,v 1.1.1.1 2001/07/21 22:14:04 goodger Exp $&＃39;

&＃61;&＃61;&＃61;VCS DATE&＃61;&＃61;&＃61;

Likewise, the date variable has been removed:

__date__ &＃61; &＃39;$Date: 2009/01/02 20:19:18 $&＃39;

&＃61;&＃61;&＃61;CHARACTER ENCODING&＃61;&＃61;&＃61;

If the coding is explicitly specified, then it should be set to the default

setting of ASCII. This can be modified if necessary (rarely in practice).

Defaulting to UTF-8 can cause anomalies with editors that have poor unicode

support.

"""

替代骨架&＃xff0c;长版本&＃xff1a;

(代码改编自DasIch的答案。)

#!/usr/bin/env python

# -*- coding: ascii -*-

"""

package.module

~~~~~~~~~~~~~

A description which can be long and explain the complete

functionality of this module even with indented code examples.

Class/Function however should not be documented here.

:copyright: year by my name, see AUTHORS for more details

:license: license_name, see LICENSE for more details

"""

#

## Code goes here.

#

def test():

""" """

pass

if __name__&＃61;&＃61;&＃39;__main__&＃39;:

test()

有很多PEP提出编码风格的建议。我缺少任何重要的最佳做法吗&＃xff1f;什么是最好的Python模块框架代码&＃xff1f;

更新

给我看看你喜欢的任何一种“最好的”。告诉我们您使用哪些指标来评定“最佳”。