UserDict 繼承與二進位讀取實戰MP3 檔案尾部 128 字節存放 ID3v1 標籤(標題、藝人、專輯、年份、註釋、流派)。本文實作 MP3FileInfo 類,繼承 UserDict 實現字典式存取,重寫 __setitem__ 實現「設定檔名自動解析」,展示 Python 物件模型與二進位檔案處理技巧。
| 欄位 | 位移 | 長度 |
|---|---|---|
| TAG 標識 | 0 | 3 |
| Title | 3 | 30 |
| Artist | 33 | 30 |
| Album | 63 | 30 |
| Year | 93 | 4 |
| Comment | 97 | 30 |
| Genre | 127 | 1 (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()
tagDataMap 宣告式定義欄位位置與解析函式,新增欄位只改字典。__setitem__ 觸發解析:設定 name 時自動解析,使用者只需 info = MP3FileInfo('song.mp3')。getFileInfoClass 依副檔名動態取得解析類,擴充新格式只需新增 XxxFileInfo 類。open(..., 'rb', 0) 無緩衝讀取,seek(-128, 2) 精準定位尾部。mutagen 庫:pip install mutagen,支援 ID3v1/v2.2/v2.3/v2.4、MP4、FLAC、OGG 等全格式。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。