Python按目录来组织模块：包（Package） - 模块（Module, 即 .py 文件）

一个模块的编写例子

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

# 模块的文档注释，任何模块代码的第一个字符串都被视为模块的文档注释
# 文档注释可以用特殊变量 __doc__ 访问
' a test module '

# 使用 __author__ 变量把作者写进去
# 类似 __xxx__ 这样的变量是特殊变量，可以被直接引用，但是有特殊用途
__author__ = 'Wesley Lien'

# 导入 sys 模块
import sys

def test():
    # sys 模块的 argv 变量为 list 类型，保存了命令行的所有参数。argv至少有一个元素，因为第一个参数永远是该.py文件的名称
    args = sys.argv
    if len(args)==1:
        print('Hello, world!')
    elif len(args)==2:
        print('Hello, %s!' % args[1])
    else:
        print('Too many arguments!')
        
# 类似 _xxx 和 __xxx 这样的函数或变量就是非公开的（private），不应该被直接引用
# private函数和变量“不应该”被直接引用，而不是“不能”被直接引用，是因为Python并没有一种方法可以完全限制访问private函数或变量
def _private_1(name):
    return 'Hello, %s' % name


# 当我们在命令行运行hello模块文件时，Python解释器把一个特殊变量 __name__ 置为 __main__ 
if __name__=='__main__':
    test()