pytaglib技术文档

1. 安装指南

使用pip进行安装：

pip install pytaglib

在大多数情况下，这将会选择一个为您的平台提供的二进制wheel，其中包含了适用于您的平台的本地TagLib库。如果这没有成功，并且安装失败，请参考以下安装说明。

2. 项目的使用说明

pytaglib是一个Python音频标签库，支持跨平台，使用简单但功能齐全。

以下是一个简单的使用示例：

import taglib

with taglib.File("/path/to/my/file.mp3", save_on_exit=True) as song:
    print(song.tags)  # 输出文件的标签信息
    print(song.length)  # 输出文件的长度（秒）

    song.tags["ALBUM"] = ["White Album"]  # 修改专辑名修改为"White Album"
    del song.tags["DATE"]  # 删除日期标签
    song.tags["GENRE"] = ["Vocal", "Classical"]  # 添加多个流派
    song.tags["PERFORMER:HARPSICHORD"] = ["Ton Koopman"]  # 添加非标准标签

在使用with语句时，如果设置了save_on_exit=True，那么在with代码块结束时，文件将会被保存。

3. 项目API使用文档

pytaglib提供了一个taglib.File类，可以通过其docstrings查看详细的API文档，或者直接查看源代码。

4. 项目安装方式

手动编译

你可以下载或检出源代码并手动编译：

pip install .

如果你想运行单元测试，可以使用以下命令：

pip install '.[tests]'
python -m pytest

如果你只是想为你的平台创建一个二进制wheel，可以使用build：

pip install --upgrade build  # 确保安装了build
python -m build

这将把wheel放在dist目录下。

Windows下的编译

安装MS Visual Studio Build Tools（或完整的IE）并按照这里详细说明配置正确的编译器版本。在Visual Studio安装程序中还应该启用_cmake_。

然后：

• 打开VS原生工具命令提示符
• 导航到_pytaglib_仓库
• 运行python build_native_taglib.py，这将下载并构建最新官方TagLib版本
• 运行python setup.py install进行安装

以上就是pytaglib的技术文档，希望能够帮助您更好地使用这个项目。