python笔记_magic变量和函数

sunfull

前言
　　先扯一点背景知识
　　PEP8（Python Enhancement Proposal）是一份python的编码规范，链接：http://www.python.org/dev/peps/pep-0008/
　　在这份编码规范中的“命名规范-命名风格”这一节的最后，提到了对几种使用前置和后置下划线的，对变量的比较特殊的命名方式：

• 单下划线开头：弱内部使用标识，无法被from M import *所引用
  
• 单下划线结尾：避免和python关键字冲突，可以加个后置下划线
  
• 双下划线开头：类成员变量中的私有变量，
  
• 双下划线开头，双下划线结尾：这是magic对象或属性的名字，永远不要将这样的命名方式应用于自己的变量和函数
  

　　本文主要关注正是以上第四种--python自动在用户命名空间创建的magic变量

1、__name__变量
　　__name__属性是直接内置在.py文件中的。

• 如果直接执行.py文件，__name__将被设置为__main__。
  
• 如果.py文件是被import，__name__将被设置为.py文件的名字
  

　　这个属性经常用来当做一个使用模式的标识：

#a.py
print 'a function'
if __name__=='__main__':
print 'a test'
------------------------------
#b.py
import a
　　如果执行python a.py将打印出两行内容，执行python b.py只会打印出'a function'。一般可以把只针对a.py的测试代码写在if __name__=='__main__'，因为如果a.py被其他的脚本import之后，这部分代码将不会被执行。可以很安全的对a.py进行单独的测试。

2、__file__变量
　　__file__可以用来获取python脚本的“路径+脚本名称”，这可能是一个相对路径也可能是一个绝对路径，取决按照什么路径来执行的脚本，一般来说__file__变量和os.path配合，可以用来获取python脚本的绝对路径：

#a.py
import os
print os.path.realpath(__file__)
out>>E:\Eclipse_workspace\python_learn\a.py
3、__import__函数
　　python导入模块时，一般使用import，而import语句其实也是调用builtin函数：__import__()实现的导入，直接使用__import__比较少见，除非导入的模块是不确定的，需要在运行时才能确定导入哪些模块，可以使用__import__，默认接收需要导入的模块名的字符串：

#a.py
def f1():
print 'f1'
def f2():
print 'f2'
#b.py
model=__import__('a')
model.f1()
model.f2()
　　在memfs的测试中，我的每一个测试case就是一个独立的.py文件，在确定需要测试哪些case后，在运行时才‘动态的’去import相应的case，就是通过__import__来实现的。

4、__str__函数
　　__str__是一个比较常用的内置函数，在定义类的时候经常使用，__str__函数返回一个字符串，这个字符串就是此对象被print时显示的内容，（如果不定义这个函数，将会显示默认的格式：<__main__.A object at 0x0000000001FB7C50>）：

#a.py
import datetime
import os
class A(object):
def __str__(self):
#返回当前的日期
return str(datetime.datetime.now())
a=A()
print a
time.sleep(1)
#每次打印A()的对象，都返回当前的时间
print a
out>>2015-06-25 15:01:01.573000
out>>2015-06-25 15:01:02.573000
　　这个函数在django的model类中如果定义的话，print一条数据库中的数据，可以指定显示任何的值：

class Question(models.Model):
#定义一个数据库表，其中包含question_id和question_text
#....
def __str__(self):
#只想显示question_text
return self.question_text
　　注：在python3.x中str被废弃，使用unicode

5、__init__对象函数
　　__init__比较常见，是对象的初始化函数，例子如下：

#a.py
class A(object):
pass
class B(A):
#B类继承自A，如果要重写__init__,需要先调用父类的__init__
def __init__(self,*args):
super(B,self).__init__(*args)
6、__new__对象函数
　　__new__()函数是类创建对象时调用的内置函数，必须返回一个生成的对象，__new__（）函数在__init__（）函数之前执行。一般来说没有比较重载这个函数，除非需要更改new对象的流程,有一种场景“单例模式”要求只能存在一个class A的对象，如果重复创建，那么返回的已经创建过的对象的引用。可以这样使用__new__函数：

a.py
class A(object):
def __new__(cls):
if not "_instance" in vars(cls):
cls._instance=super(A,cls).__new__(cls)
return cls._instance
a=A()
b=A()
print id(a)==id(b)
out>>True
　　可以看出，a和b其实引用了同一个对象

7、__class__对象变量
　　instance.__class__表示这个对象的类对象，我们知道在python中，类也是一个对象（好理解么），例：

#a.py
class A(object):
pass
a=A()
B=a.__class__
b=B()
print type(b)
out>><class '__main__.A'>
　　可以看出，a是A类的一个对象，a.__class__就是A类，将这个类赋值给B，使用B()又可以创建出一个对象b，这个对象b也是A类的对象，（晕了么？），这个__class__有什么卵用呢？下面的例子就可以用到

8、__add__对象函数
　　这其实是一类函数，包括__sub__，__mul__，__mod__，__pow__，__xor__,这些函数都是对加、减、乘、除、乘方、异或、等运算的重载，是我们自定义的对象可以具备运算功能：

#a.py
class A(object):
def __init__(self,v):
self.v=v
def __add__(self,other):
#创建创建一个新的对象
x=self.__class__(self.v+2*other.v)
return x
a=A(1)
b=A(2)
c=a+b
print c.v
ouot>>5
　　这样我们就定义了一个加法操作1+2=1+2*2=5

9、__doc__文档字符串
　　python建议在定义一个类、模块、函数的时候定义一段说明文字，例子如下：

#c.py
"""
script c's doc
"""
class A(object):
"""
class A's doc
"""
pass
def B():
"""
function B's doc
"""
pass
print __doc__
print A.__doc__
print B.__doc__
out>>script c's doc
out>>class A's doc
out>>function B's doc
　　调用别的模块、函数的时候如果不清楚使用方法，也可以直接查看doc文档字符串

10、__iter__和next函数
　　凡是可以被for....in的循环调用的对象，我们称之为可以被迭代的对象，list，str，tuple都可以被迭代，它们都实现了内部的迭代器函数，比如说list，tuple，字符串这些数据结构的迭代器如下：

a=[1,2,3,4]
b=('i',1,[1,2,3])
print a.__iter__()
print b.__iter__()
out>><listiterator object at 0x0000000001CC7C50>
out>><tupleiterator object at 0x0000000001CC7B00>
　　如果我们要实现一个我们自己的迭代器对象，那么我们必须实现两个默认的方法:__iter__和next。
　　__iter__()函数将会返回一个迭代器对象，next()函数每次被调用都返回一个值，如果迭代完毕，则raise一个StopIteration的错误，用来终止迭代。下面的例子将实现一个可以迭代的对象，输出a~z的26个字母，该对象接收一个int参数用来表示输出字母的数量，如果该参数超过字母表的长度，则循环从‘a-z’再次进行循环输出：

import random
class A(object):
def __init__(self,n):
self.stop=n
self.value=0
#字母列表
self.alph=[chr(i) for i in range(97,123)]
def __iter__(self):
return self
def next(self):
#如果超过长度超过26则重置
if self.value==len(self.alph):
self.value=0
self.stop=self.stop-len(self.alph)
#最终，已完成n个字符的输出，则结束迭代
if self.value>self.stop:
raise StopIteration   
x=self.alph[self.value]
self.value+=1
return x
for i in A(1000):
print i,
out>>a b c d e f g h i j k l m n o p q r s t u v w x y z a b c d e f g h i j k l m n o p q r s t u v w x y z a b c d e f g h i j k .....
11、__dict__、__slot__和__all__
　　这三个变量有一些关系，__dict__在类和对象中都存在，它是一个包含变量名和变量的字典，见以下的例子：

#a.py
class A(object):
c=3
d=4
def __init__(self):
self.a=1
self.b=2
def func(self):
pass
print A().__dict__
print A.__dict__
out>>{'a': 1, 'b': 2}
out>>{'__module__': '__main__', 'd': 4, 'c': 3, 'func': <function func at 0x00000000021F2BA8>, '__dict__': <attribute '__dict__' of 'A' objects>, '__weakref__': <attribute '__weakref__' of 'A' objects>, '__doc__': None, '__init__': <function __init__ at 0x00000000021F2AC8>}
　　一个对象的__dict__只包含self定义的变量，而一个类的__dict__包含了类里面的函数（func函数）、类变量，以及很多隐性的变量，包括__dict__变量本身也是隐性的。
　　__slot__变量的用法理解起来比较要难一点，正常的情况下，我们实例化一个对象，可以给这个对象增加任意的成员变量，即使不在类里面定义的变量都可以，如下：

#a.py
class A(object):
def __init__(self):
self.a=1
self.b=2
a=A()
#给a增加一个x变量
a.x=1
#也可以给a增加一个匿名函数
a.y=lambda x,y:x*y
print a.x
print a.y(3,5)
out>>1
out>>15
　　如果我们想限制一下对象绑定的变量，我们可以在类定义的时候增加一个slots变量，这个变量是一个字符串的元组，例子如下：

class A(object):
__slots__=('a','b','x')
def __init__(self):
self.a=1
self.b=2
pass
#__slots__=('a','b',)
def func(self):
pass
a=A()
a.x=1
#执行到a.y时会报错：AttributeError: 'A' object has no attribute 'y'
a.y=lambda x,y:x*y
print a.y(3,5)
　　__all__变量是一个字符串列表，它定义了每一个模块会被from module_name import *这样的语句可以被import的内容（变量，类，函数）

#a.py 不定义__all__
class A(object):
def __init__(self):
self.a=1
self.b=2
def func(self):
pass
def B():
pass
c=10
#b.py
from a import *
print A
print B
print c
out>><class 'learn_draft.A'>
out>><function B at 0x00000000021D1438>
out>>10
　　如果在a.py中定义__all__=['A','c'],则B函数对于b.py来说是不可见的。

12、__hash__
　　哈希函数，在python中的对象有一个hashable（可哈希）的概念，对于数字、字符串、元组来说，是不可变的，也就是可哈希的，因此这些对象也可以作为字典的key值。另外，列表、字典等，是可变对象，因此也就是不可哈希的，也就不能作为字典的key值。是否可哈希，可以调用内置函数hash()进行计算，hash()函数返回计算的到的hash值。

• 完全相同的变量，调用哈希算法的到的hash值一定是相同的
  

　　当然一般来说，我们不会去重新定义一个对象的__hash__函数，除非我们想实现一个自定义的需求，在stackoverflow有人提出这样一个需求，需要判断有相同词频的字符串是相等的，也就是说“abb”和“bab”这样的字符串是相等的，这个时候我们可以继承字符串类，然后重写哈希函数，如下：

import collections
class FrequencyString(str):
    @property
def normalized(self):
try:
return self._normalized
except AttributeError:
self._normalized = normalized = ''.join(sorted(collections.Counter(self).elements()))
return normalized
def __eq__(self, other):
return self.normalized == other.normalized
def __hash__(self):
return hash(self.normalized)
13、__getattr__和__setattr__，__delattr__对象函数
　　先介绍两个内置函数，getattr()和setattr(),使用这两个函数可以获取对象的属性，或者给对象的属性赋值：

#a.py
class A(object):
def __init__(self):
self.a=1
self.b=2
a=A()
setattr(a,'a',3)
print a.a
print getattr(a,'b')
out>>3
out>>2
　　其实使用这两个函数和直接访问a.a,a.b没有任何区别，但好处是setattr和getattr接受两个字符串去确定访问对象a的哪一个属性，和__import__一样，可以在运行时在决定去访问对象变量的名字，在实际工作中经常会使用这两个函数。
　　__getattr__()这个函数是在访问对象不存在的成员变量是才会访问的，见下面的例子：

class A(object):
def __init__(self):
self.a=1
self.b=2
def func(self):
pass
def __getattr__(self,name):
print 'getattr'
return self.a
a=A()
print a.d
out>>getattr
out>>1
　　在调用a.d时，d不是a的成员变量，则python会去查找对象是否存在__getattr__()函数，如果存在，则返回__getattr__()函数的返回值，我们这里返回的是self.a的值1。
　　由于__getattr__()的特性，我们可以将__getattr__()设计成一个公共的接口函数，在autotest的proxy.py中就看到了这样的用法：

class ServiceProxy(object):
def __init__(self, serviceURL, serviceName=None, headers=None):
self.__serviceURL = serviceURL
self.__serviceName = serviceName
self.__headers = headers or {}
def __getattr__(self, name):
if self.__serviceName is not None:
name = "%s.%s" % (self.__serviceName, name)
return ServiceProxy(self.__serviceURL, name, self.__headers)
#调用的时候，op是执行的特定操作的字符串，op传入__getattr__将会把ServiceProxy对象重新的内部变量重新赋值，然后返回一个更新之后的对象
function = getattr(self.proxy, op)
　　__setattr__和__getattr__不一样，对象的所有属性赋值，都会经过__setattr__()函数，看下面的例子：

class A(object):
def __init__(self):
self.a=1
self.b=2
def func(self):
pass
def __getattr__(self,name):
print 'getattr'
return self.a
def __setattr__(self, name, value):
print 'setattr %s' % name
if name == 'f':
return object.__setattr__(self,name,value+1000)
else:
return object.__setattr__(self,  name, value)
a=A()
a.f=1000
print a.f
out>>setattr a
out>>setattr b
out>>setattr f
out>>2000
　　从输出可以看到init函数的self.a和self.b的赋值也经过了__setattr__，而且在赋值的时候我们自定义了一个if逻辑，如果name是‘f’，那么value会增加1000，最终的a.f是2000
　　__delattr__不举例了，删除一个对象属性用的。

14、__call__对象函数
　　如果一个对象实现了__call__()函数，那么这个对象可以认为是一个函数对象，可以使用加括号的方法来调用，见下面例子：

class A(object):
def __init__(self):
self.li=['a','b','c','d']
def func(self):
pass
def __call__(self,n):
#返回li列表的第n个元素
return self.li[n]
a=A()
#a可以当做函数一样调用
print a(0),a(1),a(2)
out>>a b c
　　在实际工作中__call__函数非常有用，可以把一个对象变成callable的对象