萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 解析 MP3 ID3v1 標籤:UserDict 繼承與二進位讀取實戰

MP3 檔案尾部 128 字節存放 ID3v1 標籤(標題、藝人、專輯、年份、註釋、流派)。本文實作 MP3FileInfo 類,繼承 UserDict 實現字典式存取,重寫 __setitem__ 實現「設定檔名自動解析」,展示 Python 物件模型與二進位檔案處理技巧。

ID3v1 結構(固定 128 字節)

欄位位移長度
TAG 標識03
Title330
Artist3330
Album6330
Year934
Comment9730
Genre1271 (byte)

核心實作


import os, sys
from UserDict import UserDict

def stripnulls(data):
    return data.replace('\x00', '').strip()

class FileInfo(UserDict):
    def __init__(self, filename=None):
        UserDict.__init__(self)
        self['name'] = filename

class MP3FileInfo(FileInfo):
    tagDataMap = {
        'title':   (3, 33, stripnulls),
        'artist':  (33, 63, stripnulls),
        'album':   (63, 93, stripnulls),
        'year':    (93, 97, stripnulls),
        'comment': (97, 127, stripnulls),
        'genre':   (127, 128, ord),
    }

    def __parse(self, filename):
        self.clear()
        try:
            fsock = open(filename, 'rb', 0)
            try:
                fsock.seek(-128, 2)  # 從檔尾倒數 128 字節
                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)  # 關鍵:無論何種 key 都要存入

def listDirectory(directory, fileExtList):
    files = [os.path.normcase(f) for f in os.listdir(directory)]
    files = [os.path.join(directory, f) for f in files
             if os.path.splitext(f)[1] in fileExtList]
    return [getFileInfoClass(f)(f) for f in files]

def getFileInfoClass(filename, module=sys.modules[FileInfo.__module__]):
    subclass = "%sFileInfo" % os.path.splitext(filename)[1].upper()[1:]
    return hasattr(module, subclass) and getattr(module, subclass) or FileInfo

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

關鍵設計亮點

  1. 資料驅動解析:tagDataMap 宣告式定義欄位位置與解析函式,新增欄位只改字典。
  2. __setitem__ 觸發解析:設定 name 時自動解析,使用者只需 info = MP3FileInfo('song.mp3')。
  3. 動態類工廠:getFileInfoClass 依副檔名動態取得解析類,擴充新格式只需新增 XxxFileInfo 類。
  4. 二進位安全:open(..., 'rb', 0) 無緩衝讀取,seek(-128, 2) 精準定位尾部。

現代化建議

  • 改用 mutagen 庫:pip install mutagen,支援 ID3v1/v2.2/v2.3/v2.4、MP4、FLAC、OGG 等全格式。
  • Python 3:UserDict → collections.UserDict,print 加括號,str/bytes 區分嚴格處理。
  • 異步批次處理:asyncio + aiofiles 並發解析大量檔案。

from mutagen.mp3 import MP3
audio = MP3("song.mp3")
print(audio.tags.get('TIT2'), audio.tags.get('TPE1'))

手寫解析器是理解檔案格式、物件模型、動態派發的最佳練習;生產環境請站在巨人肩膀上用 mutagen。

copyright © 萬盛學電腦網 all rights reserved