Python学习笔记：模块

一时失言乱红尘 2023-07-02 08:24 8阅读 0赞

### 文章目录 ###

*   *  导入模块
     *   *  代码导入自定义模块
         *  放入指定目录
     *  包
     *  模块详解
     *   *  变量\_\_all\_\_
         *  help函数
         *  文档
         *  源码

## 导入模块 ##

通过import将函数从外部导入到程序中：

>>>import math
    >>>print(math.sin(0))
    0.0

### 代码导入自定义模块 ###

任何python程序都可作为模块导入。  
编写以下程序，并且保存为hello.py，文件名hello既是模块的名称：

#hello.py
    print("hello, world! ")

然后将hello.py所在的目录导入程序中

>>>import sys
    >>>sys.path.append('/Users/tangbincheng/Desktop')
    >>>import hello
    hello, world!

### 放入指定目录 ###

找出sys的变量path的目录列表：

>>>import sys,pprint
    >>>pprint.pprint(sys.path)
    ['/Users/tangbincheng/PycharmProjects/untitled1',
     '/Users/tangbincheng/PycharmProjects/untitled1',
     '/Applications/PyCharm.app/Contents/plugins/python/helpers/pycharm_display',
     '/Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.7/lib/python37.zip',
     '/Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.7/lib/python3.7',
     '/Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.7/lib/python3.7/lib-dynload',
     '/Users/tangbincheng/PycharmProjects/untitled1/venv/lib/python3.7/site-packages',
     '/Users/tangbincheng/PycharmProjects/untitled1/venv/lib/python3.7/site-packages/setuptools-40.8.0-py3.7.egg',
     '/Users/tangbincheng/PycharmProjects/untitled1/venv/lib/python3.7/site-packages/pip-19.0.3-py3.7.egg',
     '/Applications/PyCharm.app/Contents/plugins/python/helpers/pycharm_matplotlib_backend']

只需要将模块放置在上述任意文件夹中，所有的程序就都能找到。但**site-packages**是最佳选择（因为它就是用来放置模块的）

## 包 ##

为组织模块，可将其编组为包 （package），包其实就是另一种模块，并且可以包含其他模块。  
模块存储在扩展名为.py的 文件中，而包含一个目录。要被python视为包，目录必须文件\_\_init\_\_.py。如果像普通模块一样导入包，文件\_\_init\_\_.py的内容就是包的内容。  
要将模块加入包中，只需将模块文件放在包目录中即可。  
例如：  
要创建一个名为drawing的包，其中包含模块shapes和colors，目录结构如下：

~/python/
    ~/python/drawing/
    ~/python/drawing/__init__.py
    ~/python/drawing/colors.py
    ~/python/drawing/shapes.py

接着导入模块

import drawing  #（1）导入drawing包 
    import drawing.colors #(2)导入drawing包中的模块colors
    form drawing import shapes #（3）导入模块shapes模块

执行语句（1）后 ，便可使用目录drawing中的\_\_init\_\_.py的内容，但不能使用模块colors和shapes的内容。  
执行（2）后，便可使用模块colors，但只能通过全限定名drawing.colors来使用。  
执行（3）后，便可使用简化名shapes来使用模块shapes。

## 模块详解 ##

要查明模块包含哪些东西，可使用函数dir，可以列出对象的所有属性或者模块的所有函数，类，变量等。  
拿标准模块copy举例：

>>>import copy
    >>>print(dir(copy))
    ['Error', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__spec__', '_copy_dispatch', '_copy_immutable', '_deepcopy_atomic', '_deepcopy_dict', '_deepcopy_dispatch', '_deepcopy_list', '_deepcopy_method', '_deepcopy_tuple', '_keep_alive', '_reconstruct', 'copy', 'deepcopy', 'dispatch_table', 'error']

打印出来的名称列表中，有些是下划线开头的，按照约定，这些意味着不能给外部调用。因此，可以做一下过滤：

>>>print([n for n in dir(copy) if not n.startswith('_')])
    ['Error', 'copy', 'deepcopy', 'dispatch_table', 'error']

### 变量\_\_all\_\_ ###

其实，可以通过调用\_\_all\_\_来将可以将模块提供给用户使用的功能（变量、函数、类 ）都打印出来。

>>>print(copy.__all__)
    ['Error', 'copy', 'deepcopy']

因此，但是用’from copy import \*'将只能得到\_\_all\_\_中列出的3个函数。  
如果要导入dispatch\_table，就必须使用from copy import dispatch\_table。  
变量\_\_all\_\_的作用最主要的作用是：模块中可能包含大量其他程序不需要的变量，函数和类，比较周全的方法就是将他们都过滤掉。  
如果不设置\_\_all\_\_，则会在以impory \* 的方式导入时，导入所有 不以下划线开头的全局名称。

### help函数 ###

标准函数help，可以提供你通常需要的所有信息：

>>>help(copy.copy)
    Help on function copy in module copy:
    
    copy(x)
        Shallow copy operation on arbitrary Python objects.
        
        See the module's __doc__ string for more info.

### 文档 ###

文档也是有关模块信息的自然来源：

>>>print(copy.__doc__)
    Generic (shallow and deep) copying operations.
    
    Interface summary:
    
            import copy
    
            x = copy.copy(y)        # make a shallow copy of y
            x = copy.deepcopy(y)    # make a deep copy of y
    
    For module specific errors, copy.Error is raised.
    
    The difference between shallow and deep copying is only relevant for
    compound objects (objects that contain other objects, like lists or
    class instances).
    ....

### 源码 ###

如果你要阅读copy的代码，可以通过\_\_file\_\_

>>>print(copy.__file__)
    /Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.7/lib/python3.7/copy.py