def stripnulls(data):
  "一個(gè)空字符串的處理函數(shù)將所有00字節(jié)的內(nèi)容替換為空字符，病將前后的空字符串去掉"
  # Python中的strip用于去除字符串的首尾字符，同理，lstrip用于去除左邊的字符，rstrip用于去除右邊的字符。
  return data.replace("\00", "").strip()
 
class FileInfo(UserDict):
  '''文件基類，存儲文件的文件名，繼承自UserDict（存儲key-value的一個(gè)類，可以重寫__setitem__，__getitem__方法，
  就可以使用[]）'''
  # self是定義時(shí)使用，使用時(shí)不需要，如果沒有參數(shù)，則filename默認(rèn)None，如果有一個(gè)參數(shù)的話，參數(shù)即為filename
  def __init__(self, filename=None):
    UserDict.__init__(self) # 初始化父類
    self["name"] = filename # 設(shè)置name為 filaname
 
class MP3FileInfo(FileInfo):
  "MP3文件的信息類，用于分析MP3文件和存儲信息"
  # tagDataMap 用于存儲MP3的Tag信息分別所在位置，( key ： 開始位置，結(jié)束位置， 處理函數(shù)),
  # stripnulls表示最開始定義的函數(shù)
  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): # 解析MP3文件
    self.clear()
    try:
      fsock = open(filename, "rb", 0) # 打開文件
      try:
        # 設(shè)置文件讀取的指針位置， seek第二個(gè)參數(shù)，2表示從文件結(jié)尾作為參考點(diǎn)，
        # -128表示還有128字節(jié)結(jié)尾的點(diǎn)，0表示文件開頭做參考點(diǎn)，1表示當(dāng)前位置做參考點(diǎn)
        fsock.seek(-128, 2)
        tagdata = fsock.read(128) # 讀取128字節(jié)的數(shù)據(jù)
      finally:
        fsock.close() # 關(guān)閉文件，注意在finally中，出錯(cuò)也需要關(guān)閉文件句柄
      if tagdata[:3] == "TAG": # 判斷是否是有效的含Tag的MP3文件
        # 循環(huán)取出Tag信息位置信息， 如3, 33, stripnulls，并依次賦給start, end, parseFunc
        for tag, (start, end, parseFunc) in self.tagDataMap.items():
          # tagdata[start:end]讀出start到end的字節(jié)，使用parseFunc處理這些內(nèi)容
          self[tag] = parseFunc(tagdata[start:end])
    except IOError: # 如果出現(xiàn)IOError，則跳過繼續(xù)
      pass
   
  # 重寫__setitem__方法，上面的self[tag] = parseFunc(tagdata[start:end])就會(huì)使用這個(gè)方法,
  # key為tag，itme為parseFunc(tagdata[start:end])
  def __setitem__(self, key, item):
    if key == "name" and item: # 如果key是 name，并且 item不為空
      self.__parse(item) # 解析MP3文件
      # problem here,should out of the if
      # FileInfo.__setitem__(self, key, item) 如果使用這個(gè)縮進(jìn)就會(huì)出現(xiàn)錯(cuò)誤
    # 之前的錯(cuò)誤點(diǎn)，注意這兒的縮進(jìn)，無論如何都會(huì)存儲key-value，使用FileInfo.__setitem__父類的方法來存儲
    FileInfo.__setitem__(self, key, item)
       
def listDirectory(directory, fileExtList):
  "獲取directory目錄下的所有fileExtList格式的文件，fileExtList是一個(gè)列表，可以有多種格式"
  fileList = [os.path.normcase(f)
    for f in os.listdir(directory)] # 列出所有 directory的文件
  fileList = [os.path.join(directory, f)
    for f in fileList
    # 過濾文件，滿足fileExtList內(nèi)的一種格式。os.path.splitext將文件分成文件名和擴(kuò)展名
    if os.path.splitext(f)[1] in fileExtList]
     
  # sys.modules[FileInfo.__module__] 獲取FileInfo.__module__模塊，其中FileInfo.__module__在此會(huì)是 main，
  # 如果被別的模塊調(diào)用的話就不是了，這是為什么不直接用“main”
  def getFileInfoClass(filename, module=sys.modules[FileInfo.__module__]):
    "定義一個(gè)函數(shù)，獲取文件的信息"
     # 獲取需要用來解析的類，如果是mp3文件結(jié)果為MP3FileInfo,其他為FileInfo
    subclass = "%sFileInfo" % os.path.splitext(filename)[1].upper()[1:]
    # 返回一個(gè)類，注意，返回的是一個(gè)“類”。使用getattr獲取moudle模塊中的subclass類
    return hasattr(module, subclass) and getattr(module, subclass) or FileInfo
  # 注意，這句話可能比較難理解， getFileInfoClass(f) (f)為什么會(huì)有兩個(gè)(f)呢，上面已經(jīng)說過getFileInfoClass(f)
  # 根據(jù)文件名返回一個(gè)解析類，這兒是返回就是MP3FileInfo,而第二個(gè)(f)就表示對這個(gè)類以f初始化MP3FileInfo(f)
  return [getFileInfoClass(f) (f) for f in fileList]
 
if __name__ == "__main__": # main函數(shù)，在別的模塊中不會(huì)允許這里面的代碼了
  for info in listDirectory("E:\\Music", [".mp3"]): # 循環(huán)獲取E:\\Music文件夾中所有的mp3文件的信息
    # 由于MP3FileInfo繼承自FileInfo,FileInfo繼承自UserDict,這個(gè)的items()就是獲取key-value集合。
    # 使用"%s=%s"格式化輸出，使用"\n".join將所有信息以換行連接。
    print "\n".join(["%s=%s" % (k, v) for k, v in info.items()])
    print # 每一個(gè)文件之后，輸出一個(gè)空行

album=What Are Words - Single

comment=pythontab

name=E:\Music\chris medina - what_are_words.mp3

title=What Are Words

artist=Chris Medina

year=2011

genre=13

 

album=After the Wedding

comment=pythontab

name=E:\Music\two fathers.mp3

title=Two Fathers

artist=pythontab

year=2010

genre=255