知识卡片

操作参考卡 · 8053.c

主程序保护区分入口与导入

理解等级:中级

if name==”main“中的代码只在该模块充当主程序时按条件执行,可调用命令行入口或自测试。普通导入时仍执行模块顶层的定义与未受保护语句;这个检查不是阻止整个文件执行或保证零导入副作用的开关。

把minmax自测试放入主程序保护可避免普通导入时自动运行测试调用;图中顶层print(name)却仍会打印。要让模块导入安静,须同时检查所有顶层副作用,不能只看到有保护块就断定无输出。

formats把selftest与sys.argv适配放入入口保护,commas和money可被其他代码调用,docstring还能供help展示。接口复用不代表原格式器覆盖全部边界,尤其浮点表示与舍入规则要按具体显示要求核对。

本例把实例创建与打印放在if name == “main“块内,使直接运行person.py时展示测试输出,通常导入person时不运行这组入口语句。保护块之外的类定义及其他顶层语句仍会执行,所以不能据此保证导入完全没有副作用;也可把独立检查放进专门测试模块。

940说明python -m 模块名按模块搜索路径定位并作为main运行,不加.py后缀;这不同于普通import时使用原模块名。包内模块可用其包限定名称启动,不能把-m后的模块名称概括成任意显式相对导入表达式。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 5 处

    • · 查看原书依据

      确定它是在执行还是在导入。例如,假设我们建立下面的模块文件,名为runme.py,它只导出了一个名为tester的函数。 这个模块定义了一个函数,让用户可以正常地导入并使用: 然而,这个模块也在末尾包含了当此文件以程序执行时,就会调用该函数的代码: 实际上,一个模块的__name__变量充当一个使用模式标志,允许它编写成一个可导入的库和一个顶层脚本。尽管简单

    • · 查看原书依据

      每次这个文件被另一个文件作为工具导入时,都会出现调用自我测试所得到的输出:这可不是用户友好的特性!改进之后,我们在__name__检查区块内封装了自我测试的调用,使其在文件作为顶层脚本执行时才会启动,而导入时则不会。 我们也在顶端打印__name__的值,目的是来跟踪它的值。Python开始加载文件时,就创建了这个用法模式的变量并对其赋值。当以顶层脚本执行这

    • · 查看原书依据

      可以把这些工具作为库的部分导入到其他的环境中: 由于这个文件使用了第15章介绍的文档字符串功能,我们也可以使用help函数来研究其工具——它充当一个通用目的的工具: 我们可以用类似的方式来使用命令行参数,为脚本提供通用的输入。这些脚本可能也会把自己的代码包装成函数和类以供导入者重用。想了解更高级的命令行处理,请参阅Python的标准库和手册中的getopt和

    • · 查看原书依据

      __name__检查模块的设计意图正是如此,这一点我们在前面已经介绍过。这需要进行如下的添加: 现在,我们得到了确实想要的操作:把文件作为顶层脚本运行的时候,测试它,因为其__name__是__main__,但随后将它作为类库导入的时候,则不会这么做: 导入的时候,文件现在定义了类,但是,没有使用它。当直接运行的时候,文件像前面一样创建了类的两个实例,并且打

    • · 查看原书依据

      作为模块__main__)。在这里省略了".py"后缀,因为文件名是一个模块: -m选项还支持使用相对导入语法来运行包中的模块,以及位于.zip包中的模块。这个开关通常用来运行pdb调试器,并且针对一个脚本调用而不是交互来从一个命令行配置profiler模块,尽管这种用法在Python 3.0中有了一些变化(配置似乎受到了Python 3.0中移除execf

    参考来源

    - 位置:《Python学习手册(原书第4版)》第24章《混合用法模式:__name__和__main__》(spine838;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0809.html;u528-ch24-002)。 - 结论依据:原文在“确定它是在执行还是在导入”附近的定义、例子或代码支撑本卡核心说明:if __name__=="__main__"中的代码只在该模块充当主程序时按条件执行,可调用命令行入口或自测试。边界按已读前提解释;示例未执行。 - 原始内容:确定它是在执行还是在导入。例如,假设我们建立下面的模块文件,名为runme.py,它只导出了一个名为tester的函数。 这个模块定义了一个函数,让用户可以正常地导入并使用: 然而,这个模块也在末尾包含了当此文件以程序执行时,就会调用该函数的代码: 实际上,一个模块的__name__变量充当一个使用模式标志,允许它编写成一个可导入的库和一个顶层脚本。尽管简单 - 位置:《Python学习手册(原书第4版)》第24章《以__name__进行单元测试》(spine838;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0809.html;u529-ch24-002)。 - 结论依据:把minmax自测试放入主程序保护可避免普通导入时自动运行测试调用;图中顶层print(__name__)却仍会打印。要让模块导入安静,须同时检查所有顶层副作用,不能只看到有保护块就断定无输出。 - 原始内容:每次这个文件被另一个文件作为工具导入时,都会出现调用自我测试所得到的输出:这可不是用户友好的特性!改进之后,我们在__name__检查区块内封装了自我测试的调用,使其在文件作为顶层脚本执行时才会启动,而导入时则不会。 我们也在顶端打印__name__的值,目的是来跟踪它的值。Python开始加载文件时,就创建了这个用法模式的变量并对其赋值。当以顶层脚本执行这 - 位置:《Python学习手册(原书第4版)》第24章《使用带有__name__的命令行参数》(spine839;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0810.html;u530-ch24-002)。 - 结论依据:formats把selftest与sys.argv适配放入入口保护,commas和money可被其他代码调用,docstring还能供help展示。接口复用不代表原格式器覆盖全部边界,尤其浮点表示与舍入规则要按具体显示要求核对。 - 原始内容:可以把这些工具作为库的部分导入到其他的环境中: 由于这个文件使用了第15章介绍的文档字符串功能,我们也可以使用help函数来研究其工具——它充当一个通用目的的工具: 我们可以用类似的方式来使用命令行参数,为脚本提供通用的输入。这些脚本可能也会把自己的代码包装成函数和类以供导入者重用。想了解更高级的命令行处理,请参阅Python的标准库和手册中的getopt和 - 位置:《Python学习手册(原书第4版)》第27章《以两种方式使用代码》(spine878;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0849.html;u580-ch24-002)。 - 结论依据:本例把实例创建与打印放在if __name__ == "__main__"块内,使直接运行person.py时展示测试输出,通常导入person时不运行这组入口语句。保护块之外的类定义及其他顶层语句仍会执行,所以不能据此保证导入完全没有副作用;也可把独立检查放进专门测试模块。 - 原始内容:__name__检查模块的设计意图正是如此,这一点我们在前面已经介绍过。这需要进行如下的添加: 现在,我们得到了确实想要的操作:把文件作为顶层脚本运行的时候,测试它,因为其__name__是__main__,但随后将它作为类库导入的时候,则不会这么做: 导入的时候,文件现在定义了类,但是,没有使用它。当直接运行的时候,文件像前面一样创建了类的两个实例,并且打 - 位置:《Python学习手册(原书第4版)》附录A 安装和配置《Python命令行选项》(spine1152;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part1123.html;u940-ch24-002)。 - 结论依据:940说明python -m 模块名按模块搜索路径定位并作为__main__运行,不加.py后缀;这不同于普通import时使用原模块名。包内模块可用其包限定名称启动,不能把-m后的模块名称概括成任意显式相对导入表达式。 - 原始内容:作为模块__main__)。在这里省略了".py"后缀,因为文件名是一个模块: -m选项还支持使用相对导入语法来运行包中的模块,以及位于.zip包中的模块。这个开关通常用来运行pdb调试器,并且针对一个脚本调用而不是交互来从一个命令行配置profiler模块,尽管这种用法在Python 3.0中有了一些变化(配置似乎受到了Python 3.0中移除execf