Python Script文件结构

Python Script 是应用广泛的一种批量自动化处理方案，同时任何的.py扩展文件在Python执行程序中都可以充当Module文件来使用，是一个于C语言中的头文件类似的东西。从Python一切皆对象的设计理念来说，只要将.py的扩展文件导入Python执行程序中后，我们就可以使用一些Python的内置方法。下面先从Python Script的文件结构开始记录。

#!/usr/bin/env python
#-*- coding:utf8 -*-

"""Document:Python Script Description"""

import os

defineGlobalVairiable = True

#define class
class TestClass(object):
    """Class description """

#define function
def testFunction(self,parameters):
    """Function description"""

#main program 程序入口
if __name__ == '__main__':
    print 'Hello world'
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

1. Script文件的首行需要指定以什么可执行程序来运行该文件的代码。 
例如：#!/usr/bin/python 指定了路径为/usr/bin下的Python程序来执行。但是在有些情况下HOST的Python执行程序不一定安装在默认的/usr/bin/目录下，使用/usr/bin/env python 则指定了在env环境变量的路径中逐一寻找Python执行程序来执行这个文件中的代码，也推荐使用第二种方法。 
2.在第二行需要指定PythonScript的编码格式 
下面两种均可以指定Script的编码格式，并没有上面区别，个人喜的选择。

#coding=utf8
#-*- coding:utf8 -*-
#encoding:utf8
#encoding=utf8
 
 
1
2
3
4

3.接下来便是文件的Document部分 
编写程序也要注重注释和文档的编写。使用”“” “”” or ”’ ”’来注释文档没有区别。在导入Python Module后，可以使用__doc__方法来查看Document。

In [16]: import pyScriptFormat

In [19]: pyScriptFormat.__doc__
Out[19]: 'Document:Python Script Description'

In [21]: pyScriptFormat.testFunction.__doc__
Out[21]: 'Function description'
 
 
1
2
3
4
5
6
7

注：当Import一个Module文件时，Python执行程序会在对其进行一次编译后，会生成.pyc扩展名的字节码文件，同时也会检查.py文件的语法问题。所以当Import出现错误时，可以考虑是否出现了语法错误。 
还可以使用Python内置的dir( )方法来查看这一个Module的内置方法和自定义的属性、方法(以__X__命名的多为系统变量)。

In [22]: dir(pyScriptFormat)
Out[22]: 
['TestClass',
 '__builtins__',
 '__doc__',
 '__file__',
 '__name__',
 '__package__',
 'defineGlobalVairiable',
 'os',
 'testFunction']
 
 
1
2
3
4
5
6
7
8
9
10
11
 
 

  
  
 
 

4.导入需要的模块 
使用 import moduleName 这样的格式来导入一个Python的模块，在.py文件中可以随时随地的使用import语句来导入Python的内置函数模块，值得注意的是，当导入的模块是自定义的Python模块文件时，需要保持与模块文件在同一目录路径下。 
5.定义全局变量、类、函数 
在定义类和函数的时候，也可以在代码块的第二行中写入类或函数的描述说明，至于定义一个类和函数的具体细节，在以后的博文中会详细的记录。 
6.程序入口 __name__ 
__name__方法可以调用当前模块的名字，当该模块是直接运行而非被其他程序导入调用的时候，则该模块的__name__ == ‘__main__’。相反，当该模块是其他程序导入的时候，则该模块的__name__ == ModuleFileName，即模块文件本身的名字。

In [7]: import pyScriptFormat

In [8]: pyScriptFormat.__name__
Out[8]: 'pyScriptFormat'
 
 
1
2
3
4

所以当我们若希望模块的主程序仅仅是在被期望执行的时候才会被执行，而不会自动执行时，可以使__name__方法来进行控制，即作为主程序的入口：

if __name__ == '__main__':
 
 
1

这样可以实现节省内存的资源，也有利于提高代码的重用性。