python 典型文件结构

#/usr/bin/env/ python     　　　　   #(1) 起始行
"this is a test module"     　　　　 #(2) 模块文档(文档字符串)
import sys
import os　　　　　　　　　　　　　　　　 #(3) 模块导入

debug = True   　　　　　　　　　　　　#(4) (全局)变量定义
class FooClass (object):
    'foo class'
    pass                           #(5) 类定义(若有) 
def test():
    'test function'
    foo = FooClass()
    
    if debug:
        print 'ran test()'         #(6) 函数定义(若有) 
if  __name__ == '__main__':        #(7) 主程序 
    test()