ما خوشحالیم که انتشار GroupDocs.Metadata برای Python نسخه 26.5 را اعلام می‌کنیم که از مه 2026 در دسترس است. این نسخه پشتیبانی از Python 3.14 را معرفی می‌کند، چرخ‌دنده‌های (wheels) خودکفا با یک runtime داخلی .NET برای Windows، Linux و macOS (Intel و Apple Silicon) ارائه می‌دهد و یک API مدرن و تایپ‌شده Python با استاب‌های صریح .pyi فراهم می‌کند—بدون نیاز به پروکسی‌های زمان اجرا. همچنین شامل AGENTS.md برای یکپارچه‌سازی آسان عامل هوش مصنوعی و LLM می‌باشد.

چه چیزهای جدیدی در این انتشار وجود دارد

  • [بهبود] بازنویسی بایندینگ Python — یک API تایپ‌شده، بر پایه overloadها با استاب‌های *.pyi بسته‌بندی‌شده (بدون پروکسی __getattr__ زمان اجرا) (METADATAPYTHON-33)
  • [ویژگی] پشتیبانی از Python 3.14 (Requires-Python اکنون >=3.5,<3.15) (METADATAPYTHON-34)
  • [ویژگی] افزودن AGENTS.md داخل بسته برای یکپارچه‌سازی عامل AI / LLM (METADATAPYTHON-35)
  • [بهبود] به‌روزرسانی به موتور GroupDocs.Metadata برای .NET نسخه 26.5 (METADATAPYTHON-36)
  • [بهبود] چرخ‌دنده‌های خودکفا با یک runtime داخلی .NET برای Windows، Linux و macOS (Intel و Apple Silicon) (METADATAPYTHON-37)

تغییرات API عمومی

  • هر کلاس، overload متد و enum اکنون به‌صورت صریح با type hintها و استاب‌های *.pyi صادر می‌شود.
  • جستجوی ویژگی‌ها از پیش‌فرض‌های ساده Python استفاده می‌کند—بدون اشیای Specification.
  • هیچ تغییر شکسته‌ای در امضای متدهای موجود وجود ندارد؛ API برای کاربران که از نسخه‌های قبلی ارتقا می‌دهند، سازگاری منبعی را حفظ می‌کند.

ویژگی‌های جدید

  • یک API مدرن و تایپ‌شده Python: تکمیل خودکار دقیق و تحلیل ایستاتیک از طریق استاب‌های .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)، با یک چرخ‌دندهٔ یونیورسال (py3-none-{platform}).

  • یکپارچه‌سازی AGENTS.md: دستیاران هوش مصنوعی (مانند Claude Code، Cursor، GitHub Copilot) اکنون می‌توانند به‌صورت خودکار سطح API، مسیرهای import و الگوهای استفاده را از طریق groupdocs/metadata/AGENTS.md در چرخ‌دندهٔ نصب‌شده کشف کنند.

مثال کد

ویرایش متادیتا با استفاده از پیش‌فرض‌ها—بدون نیاز به اشیای 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 در دسترس هستند.

دانلود مستقیم

آخرین نسخه را از صفحهٔ GroupDocs.Metadata for Python via .NET 26.5 دانلود کنید.

منابع