Python中规范定义命名空间的一些建议

 更新时间:2016年06月04日 12:03:17   作者:mattkang  
命名空间是Python程序的一大根本,编程时持命名空间的整洁还是十分必要的,这里就来为大家总结Python中规范定义命名空间的一些建议,需要的朋友可以参考下

API的设计是一个艺术活。往往需要其简单、易懂、整洁、不累赘。
很多时候,我们在底层封装一个方法给高层用,而其它的方法只是为了辅助这个方法的。
也就是说我们只需要暴露这个方法就行,不用关心这个方法是怎么实现的,不用关心其它辅助方法的存在。
在Python中,有几种策略来保持命名空间的整洁。

1.变量命名用下划线_开头
下划线_开头的变量在其它模块from xxx import *的时候不被import。
如果你看decimal的源码,就会发现多次把import 的模块弄成下划线_开头的别名。
http://hg.python.org/cpython/file/2.7/Lib/decimal.py
比如

import copy as _copy
import math as _math
import numbers as _numbers

这不是蛋疼,是为了不污染命名空间

2.定义__all__
python的魔术方法实在是灵活。
假设我模块中有3个方法a(),b(),c()
我只是要暴露a而已,不需要暴露b和c。
这时__all__=[a]
在其它模块from xxxmodule import *的时候就只import了a了。
而且在开发者阅读源码的时候,看到了__all__,一下子就知道要暴露的是哪些方法,而不是一堆代码无从下手。

3.在使用了这个变量后删掉
通过del xxx删掉。
这样在dir(xxxmodule)的时候就减少了dir出来满屏的变量了。
同样在decimal的源码,可以看到使用了正则表达式模块re之后,用del re删掉了。
还有一种方法就是把import语句放在函数内,将其限制在局部作用域中。感觉这种方法不pythonic,就不推荐了。

相关文章

  • 如何在Python中编写并发程序

    如何在Python中编写并发程序

    让计算机程序并发的运行是一个经常被讨论的话题,今天我想讨论一下Python下的各种并发方式。
    2016-02-02
  • python爬虫之自动登录与验证码识别

    python爬虫之自动登录与验证码识别

    这篇文章主要为大家详细介绍了python爬虫之自动登录与验证码识别,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-09-09
  • python导入时小括号大作用

    python导入时小括号大作用

    这篇文章主要介绍了python导入时小括号的大作用,非常的简单实用,希望这个小技巧能够帮到大家
    2017-01-01
  • Python元组Tuple常用函数详解

    Python元组Tuple常用函数详解

    Python元组Tuple使用小括号()包裹,元素之间使用逗号,间隔,元组与列表相似,但元组的元素不可变,本文就给大家详细介绍一下元组的常用函数以及基本操作,感兴趣的朋友可以参考阅读下
    2023-07-07
  • matplotlib简介,安装和简单实例代码

    matplotlib简介,安装和简单实例代码

    这篇文章主要介绍了matplotlib简介,安装和简单实例代码,具有一定借鉴价值,需要的朋友可以参考下。
    2017-12-12
  • 深入探讨Python中的RegEx模式匹配

    深入探讨Python中的RegEx模式匹配

    正则表达式通常缩写为 regex,是处理文本的有效工具,这篇文章主要来和大家深入探讨一下Python中的RegEx模式匹配,感兴趣的可以了解一下
    2023-07-07
  • python分布式系统Celery安装使用实例讲解

    python分布式系统Celery安装使用实例讲解

    这篇文章主要为大家介绍了python分布式系统Celery安装使用实例讲解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-12-12
  • python批量赋值操作实例

    python批量赋值操作实例

    今天小编就为大家分享一篇python批量赋值操作实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-10-10
  • Python实现简单的ui界面的设计步骤(适合小白)

    Python实现简单的ui界面的设计步骤(适合小白)

    当我们书写一个python程序时,我们在控制台输入信息时,往往多有不便,并且为了更加美观且直观的方式输入控制命令,我们常常设计一个ui界面,这样就能方便执行相关功能,如计算器、日历等界面,本博客是为了给ui设计的小白进行讲解,需要的朋友可以参考下
    2024-07-07
  • Python自定义函数定义,参数,调用代码解析

    Python自定义函数定义,参数,调用代码解析

    这篇文章主要介绍了Python自定义函数定义,参数,调用代码解析,具有一定借鉴价值,需要的朋友可以参考下。
    2017-12-12

最新评论