[Python]模块文件结构

原创文章，欢迎转载。转载请注明：转载自 祥的博客

原文链接：http://blog.csdn.net/humanking7/article/details/45286937

---

1.Python文件结构

1.1.文件结构(范例全文)

	#/usr/bin/env python
	
	"this is a test module"
	
	import sys
	import os
	
	debug = True
	
	class FooClass (object):
	    "Foo class"
	    
	    pass
	
	def test():
	    "test function"
	    foo = FooClass()
	
	    if debugL
	        print 'ran test()'
	
	if __name__ == '__main__'
	    test()

1.2.文件结构(分行介绍)

(1)起始行(指定使用的Python的版本)

	#/usr/bin/env python

(2)模块文档(文档字符串，如果跨行用三个单引号扩起来)

	"this is a test module"

(3)模块导入

	import sys
	import os

(4)(全局)变量定义

	debug = True

(5)类定义(若有)

	class FooClass (object):
	    "Foo class"
	    
	    pass

(6)函数定义(若有)

	def test():
	    "test function"
	    foo = FooClass()
	
	    if debugL
	        print 'ran test()'

(7)主程序

	if __name__ == '__main__'
	    test()

1.3.说明

主程序

• 无论当前模块是被背的模块导入还是作为脚本直接运行，都会执行这部分代码

注意： 所有的模块都有能力执行代码

• 最高级别的Python语句(没有缩进的)在模块被导入时就会执行，无论是否真的需要执行
• 妥当的做法：除了那些真正需要执行的代码以外，所有的功能代码都通过函数建立，因此：
  • 仅在主程序模块中编写大量的顶级可执行代码
  • 用于被导入的模块只应该存在较少的顶级执行代码

__name__ 指示模块应该如何被加载 ( 这样能够做到模块的 自检 )

• 如果模块是被导入的，__name__ 的值是 模块的名字
• 如果模块是直接执行，__name__ 的值是 __main__

2. 扩展

Python自定义包及3种包导入方式

---