首页 > 代码库 > python高级编程之选择好名称:pepe8和命名最佳实践
python高级编程之选择好名称:pepe8和命名最佳实践
# # -*- coding: utf-8 -*-
# # python:2.x
# __author__ = ‘Administrator‘
# my_list=[‘a‘,‘b‘,‘c‘,‘d‘]
# """
# 大部分标准程序加在构建时都不会忽略可用性，看下面的例子理解下这句话的含义
# """
# if ‘e‘ not in my_list:
# my_list.append(‘e‘)
# print my_list
# #[‘a‘, ‘b‘, ‘c‘, ‘d‘, ‘e‘]
# #这是编写python程序和其他语言相比更加简单的原因之王，当编写一段程序时，思路很快就能够转换为代码行
# #3点是本章的重点
# """
# 使用pep8中描述的命名约定，以及一组命名最佳实践
# 命名空间重构
# 使用API，从初始模型到其重构模型
# """
# #pepe8和命名最佳实践:地址:www.python.org/dev/peps/pepe-008,提供了一些与编码风格相关的指南
# #不同的命名风格包括
# """
# CamelCase(每个单词首字母大写)
# minedCase与CamelCase类似，但是第一个单词的首字母仍然为小写
# UPPERCASE(大写)，和ER_CASE_WITH_UNDERSCORES（大写并且带下划线）
# lowercase(小写)和lower_case_with_underscores(小写并且带下划线)
# 前缀(_leading)和后缀(trailing_)下划线或者都加下划线(__doubled__)
# 小写和大写元素通常是一个单词，使用下划线通常是缩写词，使用单词会更好一些，前缀和后缀用来标记私有和特殊元素
# """
# #变量
# #常量：不会出现变化的全局变量，使用大写和一个下划线，告诉我们开发人员指定的变量表示一个恒定值
# #注意：在python里面没有真正的常量-c++用const定义那种常量，任何变量都可以修改，这就是python使用命名约定来将一个变量标记为常量的原因
# """
# 例如 ，doctest模块提供了一个选项标志和指令的列表（参考http://docs.python.org/lib/doctest-options.html）
# """
# from doctest import IGNORE_EXCEPTION_DETAIL,REPORT_ONLY_FIRST_FAILURE
# #虽然变量名看上去相当长，是清晰的描述了它们很重要，基本上都在初始化代码中使用它们，而不会在代码本身主体中使用，所以冗长名称并不会令人厌烦
# #大部分的情况，缩写名称会使代码变得模糊，在缩写名称不够清晰时，不要害怕使用完整的语句
# #一些常量的名称也是基于低层技术派生的，例如
# import os
# try:
# os._exit(0)
# except os.EX_SOFTWARE:
# print ‘interanl sortwar error‘
# raise
# #使用常量时，将它们集中放在模块头部是一个好办法，当用于如下操作时，应该将其组合在新的变量之下
# TeSt_optinos=(Ellipsis|IGNORE_EXCEPTION_DETAIL|REPORT_ONLY_FIRST_FAILURE)
# #命名和使用
# #常量用来定义一组程序所依赖的值，如默认配置文件名称，将所有常量集中放在包中独立文件中是一种好办法
# #config.py
# SQL_USER=‘tarek‘
# SQL_PASSWORD=‘secret‘
# SQL_URL=‘postgres://%s:%s@localhost/db‘%(SQL_USER,SQL_PASSWORD)
# MAX_THREADS=4
# #另一种方法是使用ConfigParser或者ZConfig（高级）之类的模块工具（用于ZOPE中描述其配置文件解析器）解析配置文件，在python这样程序文件能够像文本文件一样易于编辑和修改语言，采用这样方法是对另一种文件格式过度使用
# #对于表现的像标志选项，将它们和布尔操作组合是一种好的方法，就像doctest和re模块,如下
# OPTIONS={}
# def reg(name):
# return OPTIONS.setdefault(name,1<<len(OPTIONS))
# def hasg(options,name):
# return bool(options&name)
# #现在定义选项
# A=reg(‘A‘)
# B=reg(‘B‘)
# C=reg(‘C‘)
#
# #然后尝试它们
# s=A|B
# print hasg(s,A)
# #当创建这样一组新的常量时，应该避免使用常量为前缀，除非模块中很多个组，模块名本身就一个常见的前缀
# """在python中，使用二进制逐位计算来组合选项是常用见方法，使用或(|)操作符可以将多个选项组合在一个整数中，而使用与(&)操作符能够检查整数中的选项，参考上面的hasg函数
# 如果这个整数可以使用<<操作符移位，以确保和组合得到整数中的另一个不相同，那就起作用，换句话说，它是2的幂（参考reg)
# """
# #公有和私有变量
# #对于易变和仅有全局变量，当它们需要被保护时应该使用小写和一个下划线，但是这样的变量不常用，因为在需要保护时，模块通常会提供gettert,setter来处理它们，在这样的情况下，一个前导下划线表示该变量为包的私有元素，如下:
# _bao=[]
# def add_bao(bao):
# _bao.append(bao)
# def get_bao():
# ‘‘‘makes sure _bao cannot be modified.‘‘‘
# return tuple(_bao)
# #位于函数和方法中变量遵循相同的规则，并且永远不会被标志为私有，因为它们对上下文来说是局部的
# #对于类或者实例变量而言，只要将变量作为公共签名一部分同，并且不能带来任何有用的信息或者冗余情况下才必须使用私有标志（即前导下划线）
# #换锯话说，如果该变量在方法内部使用，用来提供一个公共特性，并且只扮演这个角色，最好将共声明为私有，如下
# #只支持一个属性的是好的私有成员
# class C(object):
# def __init__(self):
# self._message=‘go‘
# def _get_mess(self):
# return self._message
# kane=property(_get_mess)
#
# print C().kane
# #另一个例子是用来保持内部状态的变量，这个值对于余下代码没有用处，但是它参与类的行为，如下
# class M(object):
# def __init__(self):
# self._peple_to_kill=[]
# def is_slapped_on_the_button_by(self,ane):
# self._peple_to_kill.append(ane)
# print ‘ouch!‘
# def reveget(self):
# print ‘10 year later...‘
# for p in self._peple_to_kill:
# print ‘%s‘%p
# a=M()
# print a.is_slapped_on_the_button_by(‘tarek‘)
# print a.reveget()
# #不要轻易断言类进行子类化时可用采用的方式
# #函数和方法
# #命名时应该使用小写和下划线，但是在标准程序库中并不是总遵守这个规则，可以找到一些使用混合大小写(mixedCase)模块，使用threading中的currentThread(这在python3000中可能会发生改变)
# #这样的编写方法的方式在小写范式成为标准之前很常见，诸如Zope之类的框架也使用了混合大小写的方法，使用它开发人员群体相当大，所以在混合大小写和小写加下划线之间做什么选择，主要取决于所使用的程序库
# #在这样的类型程序库环境中，最正统的方法只对被输出到框架中的元素和混合大小写，其他代码保持作pep风格
# #1关于私有元素的争论
# """
# 对于私有方法和函数而言，命名惯性是添加一个前导下划线，考虑到python名称改编特性，这个规则是相当有争议的，当方法有2个前导下划线时，解释程序会立即对其更名，以避免和子类中的方法产生冲突
# 如下
# """
class Base(object):
def __secret(self):
print ‘1‘
def public(self):
self.__secret()
# #print Base.__secret()AttributeError: type object ‘Base‘ has no attribute ‘__secret‘
print dir(Base)
class B1(Base):
def __secret(self):
print ‘new ver‘
B1().public()
#python中设计名称改编（name mailing)的原始动机是不提供类似c++中私有机关(gimmick)，而是用来确保一些基类隐式的避免子类中的关窗，尤其在多重继承环境中，但是如果针对每个特性都使用它，就会使代码变得模糊不清，这根本不是python风格
#有些人认为应该始终使用显式名称，改编，如下，_a(self)另这样做
class AA(object):
def _a(self):
pass
#该类将在整个代码中不断重复，因为__是首选的
#正如BDFL(GUIDO,BENEVLOENT DICTATOR FOR LIFE,参考:en.wikipedia.org/wiki/BDFL)所说，是通过在子类中编写方法之前查看__mro__来避免名称改编，改变基类的私有方法必须小心进行
#具体可以看下http://mail.python.org/pipermail/python-dev/2005-December/058555.html上查找
#BENEVLOENT DICTATOR FOR LIFE(即仁慈大帝)
#特殊方法：docs.python.org/ref/specialnames.html，是以2个下划线开始和结束的，常规方法不应该使用这种命名约定，被用于操作符重载等，如下
class W(int):
def __add__(self, other):
return int.__add__(self,other)+1
def __repr__(self):
return‘weibor%d‘%self
#
#公有api
#
def do_this(self):
print ‘this‘
def do_that(self):
print ‘that‘
#对于常用的方法，绝不应该使用这种名称，所以不要创建如下名称方法;
class Ba(object):
def __my_methond__(self):
pass
#参数:使用小写，如果需要的话可以加上下划线，它们遵守与变量相同命名规则
#属性用小写或者小写加上下划线命名的，大部分的时候，表示对象的状态，可以是一个名词或者形容词，在需要的时候可以也是小短语，如下
class Coi(object):
_c=[]
def v(self,a):
self._c.append(a)
def _cc(self):
return ‘‘.join(self._c)
connect=property(_cc)
aa=Coi()
aa.v(‘tt‘)
#类的名称问题是使用CamelCase格式命名，当定义是模块的私有类是，还可能有一个前导下划线
#类和实例变量常常是名词短语，其使用逻辑与用动词短语命名方法一致，如下
class DS(object):
def ope(self):
pass
class USER(object):
pass
a=USER()
db=DS()
db.ope()
#模块和名
#除了特殊模块__init__之外，模块名称都使用不带下划线的小写字母命名，如下
"""
os,sys,shbutil
当模块对于包而言是私有的时候，将添加一个前导下划线，编译过c或者c++模块名称通常带有一个下划线并且将导入到纯python模块中
包遵守相同规则，因为它们在命名空间中表现和模块类似
"""
python高级编程之选择好名称:pepe8和命名最佳实践