更新模块代码编写基础

Author: GitLanx

Learning Python/5、模块和包/2. 模块代码编写基础.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# 模块的创建  \n",
+    "# 1. 模块的创建  \n",
     "定义模块，只要使用文本编辑器，把一些 Python 代码输入至文本文件中，然后以“.py”为后缀名进行保存，任何此类文件都会被自动认为是 Python 模块。在模块顶层指定的所有变量名都会变成其属性，并且可以导出供客户端来使用。  \n",
     "\n",
     "例如，如果在名为 module1.py 的文件中输入下面的 def 语句，并将这个文件导入，就会创建一个拥有一个属性的模块对象。"
@@ -24,13 +24,13 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 模块文件名  \n",
+    "## 1.1 模块文件名  \n",
     "模块名在 Python 程序中会变成变量名（没有.py）。当一个模块被导入时，Python 会把内部模块名映射到外部文件名，也就是说通过把模块搜索路径中的目录路径加在前边，而 .py 或其他后缀名添加在后边。  \n",
     "\n",
-    "# 模块的使用  \n",
+    "# 2. 模块的使用  \n",
     "客户端可以执行 import 或 from 语句。import 会读取整个模块，所以必须进行定义后才能读取它的变量名；from 将获取（或者说复制）模块特定的变量名。  \n",
     "\n",
-    "## import 语句  \n",
+    "## 2.1 import 语句  \n",
     "上面的变量名 module1 有两个不同的目的：识别要被载入的外部文件，同时会生成脚本中的变量，在文件加载后，用来引用模块对象。"
    ]
   },
@@ -63,7 +63,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## from 语句  \n",
+    "## 2.2 from 语句  \n",
     "因为 from 会把变量名复制到另一个作用域，所以它就可以让我们直接在脚本中使用复制后的变量名，而不需要通过模块。"
    ]
   },
@@ -89,7 +89,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## from * 语句  \n",
+    "## 2.3 from * 语句  \n",
     "当我们使用 * 时，会取得模块顶层所有赋了值的变量名的拷贝。还是在脚本中使用复制后得到的变量名 printer，而不需要通过模块名。"
    ]
   },
@@ -115,7 +115,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 导入只发生一次  \n",
+    "## 2.4 导入只发生一次  \n",
     "模块会在第一次 import 或 from 时载入并执行，并且只在第一次如此。之后的导入操作都只会取出已加载的模块对象。  \n",
     "\n",
     "**初始化代码**"
@@ -182,7 +182,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## import 和 from 是赋值语句  \n",
+    "## 2.5 import 和 from 是赋值语句  \n",
     "import 和 from 是可执行的语句，可以嵌套在 if 测试中，出现在函数 def、try 语句之中等。  \n",
     "\n",
     "import 和 from 都是隐形的赋值语句：\n",
@@ -194,7 +194,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## import 和 from 的对等性  \n",
+    "## 2.6 import 和 from 的对等性  \n",
     "一个像这样的 from 语句：\n",
     "```\n",
     "from module import name1, name2\n",
@@ -212,14 +212,14 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# 模块命名空间  \n",
-    "## 文件生成命名空间  \n",
+    "# 3. 模块命名空间  \n",
+    "## 3.1 文件生成命名空间  \n",
     "- **模块语句会在首次导入时执行。**\n",
     "- **顶层的赋值语句会创建模块属性。**\n",
     "- **模块的命名空间能通过属性 `__dict__` 或 dir(M) 获取。**\n",
     "- **模块是一个独立的作用域（本地变量就是全局变量）。**\n",
     "\n",
-    "## 命名空间字典：`__dict__`  \n",
+    "## 3.2 命名空间字典：`__dict__`  \n",
     "在内部模块命名空间是作为字典对象进行存储的。可以通过模块的 `__dict__` 属性获取模块命名空间字典："
    ]
   },
@@ -255,7 +255,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## 属性名的点号运算  \n",
+    "## 3.3 属性名的点号运算  \n",
     "在 Python 中，可以使用点号运算语法 object.attribute 获取任意 object 的 attribute 属性。  \n",
     "\n",
     "属性的点号运算与作用域法则无关，LEGB 规则只适用于无点号运算的纯变量名。以下是其规则：\n",
@@ -264,7 +264,7 @@
     "- **多层点号运算。**X.Y.Z 指的是寻找对象 X 之中的变量名 Y，然后再找对象 X.Y 之中的 Z。\n",
     "- **通用性。**点号运算可用于任何具有属性的对象：模块、类、C 扩展类型等。\n",
     "\n",
-    "## 导入和作用域  \n",
+    "## 3.4 导入和作用域  \n",
     "导入操作不会赋予被导入文件中的代码对上层代码的可见度：被导入文件无法看见进行导入的文件内的变量名。更确切的说法是：\n",
     "- 函数绝对无法看见其他函数内的变量名，除非它们从物理上处于这个函数内。\n",
     "- 模块程序代码绝对无法看见其他模块内的变量名，除非明确地进行了导入。\n",
@@ -276,14 +276,14 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# 重载模块  \n",
+    "# 4. 重载模块  \n",
     "调用 reload 内置函数可以强制使模块代码重新载入并重新运行。此文件中新的代码的赋值语句会在适当的地方修改现有的模块对象。  \n",
     "\n",
     "reload 函数可以修改程序的一些部分，而无需停止整个程序。因此，利用 reload，可以立即看到对组件的修改的效果。  \n",
     "\n",
     "在 Python 3.X 中，reload 在 imp 标准库模块中，需要 import 语句或 from 语句来载入该工具。  \n",
     "\n",
-    "## reload 基础  \n",
+    "## 4.1 reload 基础  \n",
     "- reload 是 Python 中的内置函数，而不是语句。\n",
     "- 传给 reload 的是已经存在的模块对象，而不是变量名。\n",
     "- reload 在 Python 3.X 中位于模块中，并且必须导入自己。\n",
@@ -305,7 +305,7 @@
     "- **重载只会对以后使用 from 的客户端造成影响。**\n",
     "- **重载只应用于单个模块。**  \n",
     "\n",
-    "## reload 实例  \n",
+    "## 4.2 reload 实例  \n",
     "下面，我们要修改并重载一个模块文件，但不会中止交互模式的 Python 会话。  \n",
     "\n",
     "首先，在文本编辑器中，编写一个名为 changer.py 的模块文件，其内容如下："
@@ -445,7 +445,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.6.5"
+   "version": "3.6.8"
   }
  },
  "nbformat": 4,