我们很高兴宣布 GroupDocs.Metadata for Python v26.5 已于 May 2026 发布。此版本引入了对 Python 3.14 的支持，提供了包含嵌入式 .NET 运行时的自包含 wheels，适用于 Windows、Linux 和 macOS（Intel 和 Apple Silicon），并交付了带有显式 .pyi 存根的现代、类型化 Python API——消除了运行时代理。它还包括 AGENTS.md，实现无缝的 AI 代理和 LLM 集成。

本次发布的新功能

  • [Enhancement] 重建了 Python 绑定——提供了类型化、每个重载的 API，并捆绑了 *.pyi 存根（无运行时 __getattr__ 代理） (METADATAPYTHON-33)
  • [Feature] 支持 Python 3.14（Requires-Python 现在为 >=3.5,<3.15） (METADATAPYTHON-34)
  • [Feature] 在包内提供 AGENTS.md，用于 AI 代理 / LLM 集成 (METADATAPYTHON-35)
  • [Enhancement] 更新至 GroupDocs.Metadata for .NET 26.5 引擎 (METADATAPYTHON-36)
  • [Enhancement] 为 Windows、Linux 和 macOS（Intel 与 Apple Silicon）提供嵌入式 .NET 运行时的自包含 wheels (METADATAPYTHON-37)

公共 API 更改

  • 每个类、方法重载和枚举现在都显式生成带有类型提示的 *.pyi 存根。
  • 属性搜索使用普通的 Python 谓词——不再需要 Specification 对象。
  • 对现有方法签名没有破坏性更改；API 对于从之前版本升级的用户保持源代码兼容。

新特性

  • 现代、类型化的 Python API：通过 .pyi 存根实现精准的自动完成和静态分析。示例用法：

    from groupdocs.metadata import Metadata

with Metadata("input.docx") as metadata:
    for prop in metadata.find_properties(lambda p: True):
        print(f"{prop.name} = {prop.value}")

  • Python 3.14 支持：完整支持 Python 3.5 至 3.14（Requires-Python: >=3.5,<3.15），并提供单一通用 wheel（py3-none-{platform}）。

  • AGENTS.md 集成：AI 助手（例如 Claude Code、Cursor、GitHub Copilot）现在可以通过已安装 wheel 中的 groupdocs/metadata/AGENTS.md 自动发现 API 表面、导入路径和使用模式。

代码示例

使用谓词编辑元数据——无需 Specification 对象：

from datetime import datetime
from groupdocs.metadata import Metadata
from groupdocs.metadata.common import PropertyValue
from groupdocs.metadata.tagging import Tags

with Metadata("input.docx") as metadata:
    metadata.set_properties(
        lambda p: Tags.time.created in list(p.tags),
        PropertyValue(datetime.now()),
    )
    metadata.save("output.docx")

# 一次性剥离所有检测到的属性
with Metadata("input.pdf") as metadata:
    removed = metadata.sanitize()
    metadata.save("clean.pdf")

如何获取更新

PyPI

通过 pip 安装或升级：

pip install --upgrade groupdocs-metadata-net

PyPI 上的包名为 groupdocs-metadata-net。已提供适用于 Windows、Linux 和 macOS 的 wheels。

直接下载

从 GroupDocs.Metadata for Python via .NET 26.5 页面下载最新发布版本。

资源