Dive Into Python 学习记录3-对获取某文件夹下MP3文件信息的代码构成分析

代码为：

"""Framework for getting filetype-specific metadata.

Instantiate appropriate class with filename.  Returned object acts like a
dictionary, with key-value pairs for each piece of metadata.
    import fileinfo
    info = fileinfo.MP3FileInfo("/music/ap/mahadeva.mp3")
    print "\\n".join(["%s=%s" % (k, v) for k, v in info.items()])

Or use listDirectory function to get info on all files in a directory.
    for info in fileinfo.listDirectory("/music/ap/", [".mp3"]):
        ...

Framework can be extended by adding classes for particular file types, e.g.
HTMLFileInfo, MPGFileInfo, DOCFileInfo.  Each class is completely responsible for
parsing its files appropriately; see MP3FileInfo for example.

This program is part of "Dive Into Python", a free Python book for
experienced programmers.  Visit http://diveintopython.org/ for the
latest version.
"""

__author__ = "Mark Pilgrim (mark@diveintopython.org)"
__version__ = "$Revision: 1.3 $"
__date__ = "$Date: 2004/05/05 21:57:19 $"
__copyright__ = "Copyright (c) 2001 Mark Pilgrim"
__license__ = "Python"

import os
import sys
from UserDict import UserDict

def stripnulls(data):
    "strip whitespace and nulls"
    return data.replace("\00", " ").strip()    #  .strip（）移除字符串首尾在括号内指定参数的字符，默认为空格

class FileInfo(UserDict):
    "store file metadata"
    def __init__(self, filename=None):
        UserDict.__init__(self)
        self["name"] = filename
    
class MP3FileInfo(FileInfo):
    "store ID3v1.0 MP3 tags"
    tagDataMap = {"title"   : (  3,  33, stripnulls),
                  "artist"  : ( 33,  63, stripnulls),
                  "album"   : ( 63,  93, stripnulls),
                  "year"    : ( 93,  97, stripnulls),
                  "comment" : ( 97, 126, stripnulls),
                  "genre"   : (127, 128, ord)}
    
    def __parse(self, filename):
        "parse ID3v1.0 tags from MP3 file"
        self.clear()
        try:
            fsock = open(filename, "rb", 0)
            try:
                fsock.seek(-128, 2)
                tagdata = fsock.read(128)
            finally:
                fsock.close()
            if tagdata[:3] == 'TAG':
                for tag, (start, end, parseFunc) in self.tagDataMap.items():
                    self[tag] = parseFunc(tagdata[start:end])
        except IOError:
            pass

    def __setitem__(self, key, item):
        if key == "name" and item:
            self.__parse(item)
        FileInfo.__setitem__(self, key, item)

def listDirectory(directory, fileExtList):
    "get list of file info objects for files of particular extensions"
    fileList = [os.path.normcase(f) for f in os.listdir(directory)]    #os.path.normcase(f)表示转换f的大小写和斜杠；os.listdir(directory)列出 dir 里面
                                                                       #的所有文件和目录，但不包括子目录中的内容
    fileList = [os.path.join(directory, f) for f in fileList \         #path.join(directory, f)把目录和文件名合成一个路径；os.path.splitext(f)[1]分割路径，
                                                                       #返回路径名和文件扩展名的元组
                if os.path.splitext(f)[1] in fileExtList]
    def getFileInfoClass(filename, module=sys.modules[FileInfo.__module__]):
        "get file info class from filename extension"
        subclass = "%sFileInfo" % os.path.splitext(filename)[1].upper()[1:] #进行大写转换
        return hasattr(module, subclass) and getattr(module, subclass) or FileInfo #hasattr(os, 'system')查看os对象是否有system属性,有返回True,否则False 
                                                                                   #getattr(os, 'system') 得到os对象的system属性
    return [getFileInfoClass(f)(f) for f in fileList]

if __name__ == "__main__":
    for info in listDirectory("E:\Kugou\Listen", [".mp3"]):
        print "\n".join(["%s=%s" % (k, v) for k, v in info.items()])
        print

输出为：

album=
comment=
name=E:\Kugou\Listen\makiyo - wake up.mp3
title=
artist=
year=
genre=12

album=needpop.com
comment=needpop.com
name=E:\Kugou\Listen\sara - 我的心好冷.mp3
title=我的心好冷(完整版)
artist=SARA needpop.com
year=2010
genre=255

album=⊙完美工作室⊙
comment=
name=E:\Kugou\Listen\三轮兄弟 斗地主 川普.mp3
title=斗地主(川普)
artist=三轮兄弟
year=
genre=0

album=绮楼ぁ听风雨收藏Qq:1505388177
comment=
name=E:\Kugou\Listen\付辛博 - 我，一个人.mp3
title=
artist=
year=
genre=255

name=E:\Kugou\Listen\伍佰、china blue - 心如刀割.mp3

name=E:\Kugou\Listen\冷漠 - 醉红颜.mp3

name=E:\Kugou\Listen\冷漠、云菲菲 - 小三.mp3

album=
comment=
name=E:\Kugou\Listen\凤凰传奇 - 大声唱.mp3
title=
artist=
year=
genre=12

解释与拓展：

>>> num
'i like pYthon'
>>> '  spacious   '.strip()
'spacious'
>>> 'www.example.com'.strip('comz.')
'www.example'
>>> 'www.example.com'.strip('comwz.')
'example'

>>> num.strip('on')
'i like pYth'
>>> num.strip('th')
'i like pYthon'
>>> 'www.example.com'.strip('comw.')
'example'
>>> 'www.example.com'.strip('comwe.')
'xampl'
>>> 'www.example.com'.strip('comwx.')
'example'
>>> 'www.example.com'.strip('lecomw.')
'xamp'

strip （）只是去除字符串首尾的第一个开始匹配的指定字符，第一次去除后若首尾还有指定字符，则继续去除，直到首尾无指定的参数，对中间的原样保留，

2、hasattr(os, 'system')查看os对象是否有system属性,有返回True,否则False ；getattr(os, 'system') 得到os对象的system属性

int PyObject_HasAttr ( PyObject  *o, PyObject  *attr_name )

Returns 1 if o has the attributeattr_name, and0 otherwise. Thisis equivalent to the Python expressionhasattr(o,attr_name). This functionalways succeeds.

int PyObject_HasAttrString ( PyObject  *o, const char  *attr_name )

Returns 1 if o has the attributeattr_name, and0 otherwise. Thisis equivalent to the Python expressionhasattr(o,attr_name). This functionalways succeeds.

PyObject* PyObject_GetAttr ( PyObject  *o, PyObject  *attr_name )

Return value: New reference.

Retrieve an attribute named attr_name from object o. Returns the attributevalue on success, orNULL on failure. This is the equivalent of the Pythonexpressiono.attr_name.

PyObject* PyObject_GetAttrString ( PyObject  *o, const char  *attr_name )

Return value: New reference.

Retrieve an attribute named attr_name from object o. Returns the attributevalue on success, orNULL on failure. This is the equivalent of the Pythonexpressiono.attr_name.

from 模块名 import 模块名
from UserDict import UserDict

它与你所熟知的 import module 语法很相似，但是有一个重要的区别：UserDict 被直接导入到局部名字空间去了，所以它可以直接使用，而不需要加上模块名的限定。你可以导入独立的项或使用frommodule import * 来导入所有东西。 

比较 import 模块名

>>> import odbchelper                              
>>> params = {"server":"mpilgrim", "database":"master", "uid":"sa", "pwd":"secret"}
>>> print odbchelper.buildConnectionString(params)   #加上模块名

使用在被导入模块中定义的函数时，必须包含模块的名字。所以不能只使用 buildConnectionString，而应该使用 odbchelper.buildConnectionString。

Python 中的frommodule import * 像Perl 中的usemodule ；Python 中的importmodule 像Perl 中的requiremodule 。

Python 中的frommodule import * 像Java 中的importmodule.* ；Python 中的importmodule 像Java 中的importmodule 。

>>> import types
>>> types.FunctionType             
<type 'function'>
>>> FunctionType                   
Traceback (innermost last):
  File "<interactive input>", line 1, in ?
NameError: There is no variable named 'FunctionType'
>>> from types import FunctionType 
>>> FunctionType                   
<type 'function'>

	types 模块不包含方法，只是表示每种 Python 对象类型的属性。注意这个属性必需用模块名 types 进行限定。
	FunctionType 本身没有被定义在当前名字空间中；它只存在于types 的上下文环境中。
	这个语法从 types 模块中直接将 FunctionType 属性导入到局部名字空间中。
	现在 FunctionType 可以直接使用，与 types 无关了。

什么时候你应该使用 from module import？

• 如果你要经常访问模块的属性和方法，且不想一遍又一遍地敲入模块名，使用 from module import。
• 如果你想要有选择地导入某些属性和方法，而不想要其它的，使用 from module import。
• 如果模块包含的属性和方法与你的某个模块同名，你必须使用 import module 来避免名字冲突。

class FileInfo(UserDict):
    "store file metadata"              
    def __init__(self, filename=None):   

	类也可以 (并且应该) 有doc strings ，就像方法和函数一样。
	__init__ 在类的实例创建后被立即调用。它可能会引诱你称之为类的构造函数，但这种说法并不正确。说它引诱，是因为它看上去像 (按照习惯，__init__ 是类中第一个定义的方法)，行为也像 (在一个新创建的类实例中，它是首先被执行的代码)，并且叫起来也像 (“init”当然意味着构造的本性)。说它不正确，是因为对象在调用__init__ 时已经被构造出来了，你已经有了一个对类的新实例的有效引用。但 __init__ 是在 Python 中你可以得到的最接近构造函数的东西，并且它也扮演着非常相似的角色。
	每个类方法的第一个参数，包括 __init__，都是指向类的当前实例的引用。按照习惯这个参数总是被称为self。在__init__ 方法中，self 指向新创建的对象；在其它的类方法中，它指向方法被调用的类实例。尽管当定义方法时你需要明确指定self，但在调用方法时，你不 用指定它，Python 会替你自动加上的。
	__init__ 方法可以接受任意数目的参数，就像函数一样，参数可以用缺省值定义，即可以设置成对于调用者可选。在本例中，filename 有一个缺省值None，即Python 的空值。

习惯上，任何 Python 类方法的第一个参数 (对当前实例的引用) 都叫做 self。这个参数扮演着 C++ 或 Java 中的保留字this 的角色，但self 在Python 中并不是一个保留字，它只是一个命名习惯。虽然如此，也请除了self 之外不要使用其它的名字，这是一个非常坚固的习惯。

类名通常是第一个字母大写；

类中的所有东西都要缩近，就像位于函数、if 语句，for 循环，诸如此类的代码。第一条不缩近的东西不属于这个类；

在 Python 中，类的基类只是简单地列在类名后面的小括号里。所以 FileInfo 类是从 UserDict 类 (它是从 UserDict 模块导进来的) 继承来的。UserDict 是一个像字典一样工作的类，它允许你完全子类化字典数据类型，同时增加你自已的行为。{也存在相似的类UserList 和UserString ，它们允许你子类化列表和字符串。)

class FileInfo(UserDict):
    "store file metadata"
    def __init__(self, filename=None):
        UserDict.__init__(self)        
        self["name"] = filename        
                                       

	一些伪面向对象语言，像 Powerbuilder 有一种“扩展”构造函数和其它事件的概念，即父类的方法在子类的方法执行前被自动调用。Python 不是这样，你必须显示地调用在父类中的合适方法。
	这个类像字典一样工作，那么这里就是第一个印象。我们将参数 filename 赋值给对象name 关键字，作为它的值。
	注意 __init__ 方法从不返回一个值。

>>> class C:
	def __init__(self,val):self.val = val
	def f(self): print "hello, my value is:", self.val

	
>>> a = C(27)
>>> b = C(42)
>>> a.f()
hello, my value is: 27
>>> b.f()
hello, my value is: 42
>>> C.f(a)
hello, my value is: 27
>>> C.f(b)
hello, my value is: 42

从上例可以看出既可以通过python自动补充参数进行实例引用，也可以通过对象将值传递；

当定义你自已的类方法时，你必须 明确将 self 作为每个方法的第一个参数列出，包括 __init__。当从你的类中调用一个父类的一个方法时，你必须包括self 参数。但当你从类的外部调用你的类方法时，你不必对self 参数指定任何值；你完全将其忽略，而Python 会自动地替你增加实例的引用。

http://www.freenetpages.co.uk/hp/alan.gauld/tutclass.htm