ما خوشحالیم که انتشار GroupDocs.Editor برای Python نسخه 26.5 را اعلام می‌کنیم که از مه 2026 در دسترس است. این اولین انتشار عمومی GroupDocs.Editor برای Python از طریق .NET است که به‌صورت یک چرخ‌دنده (wheel) خودکفا در PyPI ارائه می‌شود. این کتابخانه قابلیت‌های کامل ویرایش اسناد کتابخانهٔ .NET زیرین را به Python می‌آورد: بارگذاری یک سند، تبدیل آن به HTML/CSS تمیز و قابل ویرایش، برنامه‌نویسی یا ویرایش آن مارکاپ در هر ویرایشگر WYSIWYG، سپس ذخیرهٔ دوباره به فرمت اصلی — یا تبدیل به فرمت دیگری — تنها با یک pip install و بدون نیاز به MS Office، OpenOffice یا زمان‌اجرای جداگانهٔ .NET.

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

  • [ویژگی جدید] ویرایش دورانی HTML (EDTPY-1)
  • [ویژگی جدید] سطح API پایتونیک با نام‌گذاری خودکار (EDTPY-2)
  • [ویژگی جدید] پشتیبانی چندفرمت در پردازش واژه‌پرداز، صفحات گسترده، ارائه‌ها، PDF، ایمیل، کتاب‌های الکترونیکی و فرمت‌های متن/مارکاپ (EDTPY-3)
  • [ویژگی جدید] تبدیل فرمت از طریق واسط HTML (EDTPY-4)
  • [ویژگی جدید] ویرایش جزئی (برگه/اسلاید/بازهٔ صفحات) با صفحه‌بندی و تغییرات متادیتای زبان (EDTPY-5)
  • [ویژگی جدید] استخراج منابع (تصاویر، فونت‌ها، CSS، صدا) و حفظ در پوشه (EDTPY-6)
  • [ویژگی جدید] بررسی سند از طریق get_document_info() (EDTPY-7)
  • [ویژگی جدید] بازرسی و به‌روزرسانی فیلدهای فرم از طریق editor.form_field_manager (EDTPY-8)
  • [ویژگی جدید] بارگذاری از جریان (stream) و پروتکل مدیر زمینه برای آزادسازی قطعی (EDTPY-9)
  • [ویژگی جدید] سازگار با AI Agent و LLM: AGENTS.md بسته‌بندی‌شده، سرور MCP و اسناد ماشین‌خوان (EDTPY-10)

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

تمام API .NET از طریق نام‌گذاری بومی پایتون در دسترس است. کلاس‌ها از PascalCase استفاده می‌کنند، متدها و ویژگی‌ها از snake_case (به‌صورت خودکار به PascalCase زیرین .NET نگاشت می‌شوند) و مقادیر enum از UPPER_SNAKE_CASE.

کلاس‌ها

  • Editor — نقطهٔ ورودی؛ باز کردن با مسیر یا جریان، edit()، save()، get_document_info()، form_field_manager
  • EditableDocument — نمای HTML/CSS؛ get_content()، get_body_content()، get_embedded_html()، get_css_content()، save()، مجموعه‌های منابع (images، fonts، css، audio، all_resources) و کارخانه‌های from_markup() / from_markup_and_resource_folder() / from_file()
  • FormFieldManager — خواندن و به‌روزرسانی فیلدهای فرم پردازش واژه‌پرداز
  • License، Metered — APIهای مجوزدهی

گزینه‌ها

  • بارگذاری: WordProcessingLoadOptions، SpreadsheetLoadOptions، PresentationLoadOptions، PdfLoadOptions
  • ویرایش: WordProcessingEditOptions، SpreadsheetEditOptions، PresentationEditOptions، PdfEditOptions، EbookEditOptions، EmailEditOptions، MarkdownEditOptions، TextEditOptions، XmlEditOptions، DelimitedTextEditOptions
  • ذخیره: WordProcessingSaveOptions، SpreadsheetSaveOptions، PresentationSaveOptions، PdfSaveOptions، HtmlSaveOptions، MhtmlSaveOptions، MarkdownSaveOptions، XpsSaveOptions، TextSaveOptions، EbookSaveOptions، EmailSaveOptions، DelimitedTextSaveOptions

Enumها

  • WordProcessingFormats، SpreadsheetFormats، PresentationFormats، FixedLayoutFormats، EBookFormats، EmailFormats، TextualFormats، FontExtractionOptions، FontEmbeddingOptions

استثناها

  • PasswordRequiredException، IncorrectPasswordException، EncryptedException، InvalidFormatException

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

ویرایش دورانی HTML

هر سند پشتیبانی‌شده را به HTML/CSS قابل ویرایش تبدیل کنید و بدون از دست دادن دقت، آن را به فرمت اصلی خود بازگردانید — این همان جریان کاری اصلی GroupDocs.Editor است. HTML می‌تواند به‌صورت برنامه‌نویسی یا در هر ویرایشگر WYSIWYG شخص ثالثی مانند CKEditor یا TinyMCE ویرایش شود.

سطح API پایتونیک

تمام API .NET از طریق نام‌گذاری بومی پایتون در دسترس است. کلاس‌ها از PascalCase، متدها و ویژگی‌ها از snake_case (به‌صورت خودکار به PascalCase زیرین .NET نگاشت می‌شوند) و مقادیر enum از UPPER_SNAKE_CASE استفاده می‌کنند.

پشتیبانی چندفرمت

یک API یکپارچه برای پردازش واژه‌پرداز، صفحات گسترده، ارائه‌ها، PDF، ایمیل، کتاب‌های الکترونیکی و فرمت‌های متن/مارکاپ.

تبدیل فرمت از طریق HTML

هیچ فراخوانی «convert» جداگانه‌ای وجود ندارد — ذخیرهٔ یک EditableDocument با *SaveOptions متفاوت، آن را از طریق واسط HTML تبدیل می‌کند. ورودی یکسان، خروجی متفاوت.

ویرایش جزئی

ویرایش یک برگهٔ واحد از یک کتاب‌کار، یک اسلاید واحد از یک ارائه یا یک بازهٔ صفحات — و امکان تغییر صفحه‌بندی و متادیتای زبان.

استخراج منابع

یک EditableDocument تصاویر، فونت‌ها، CSS و صداهای استخراج‌شده را به‌صورت مجموعه‌های قابل تکرار ارائه می‌دهد و می‌تواند HTML به‌همراه تمام منابع را در یک پوشه ذخیره کند.

بررسی سند

خواندن فرمت، تعداد صفحات، اندازه و وضعیت رمزنگاری بدون نیاز به یک عبور کامل ویرایشی.

فیلدهای فرم

بازرسی و به‌روزرسانی فیلدهای فرم پردازش واژه‌پرداز از طریق editor.form_field_manager.

جریان‌ها و مدیران زمینه

بارگذاری از هر جریان باینری و استفاده از پروتکل مدیر زمینه برای آزادسازی قطعی دستگیره‌های سند بومی.

AI Agent و سازگاری با LLM

  • AGENTS.md بسته‌بندی‌شده در داخل چرخ‌دندهٔ نصب‌شده — Claude Code، Cursor و GitHub Copilot به‌صورت خودکار سطح API، الگوهای استفاده و نکات عیب‌یابی را کشف می‌کنند.
  • سرور MCP — ابزار AI خود را به https://docs.groupdocs.com/mcp ارجاع دهید تا اسناد را به‌صورت درخواست‑به‑درخواست دریافت کنید.
  • اسناد ماشین‌خوان در https://docs.groupdocs.com/editor/python-net/llms-full.txt برای RAG و زمینهٔ LLM.

مثال کد

from groupdocs.editor import Editor, EditableDocument
from groupdocs.editor.formats import WordProcessingFormats
from groupdocs.editor.options import WordProcessingSaveOptions

with Editor("document.docx") as editor:
    editable = editor.edit()                       # document -> editable HTML
    html = editable.get_embedded_html()
    edited = EditableDocument.from_markup(html.replace("Hello", "Goodbye"))
    editor.save(edited, "document.docx", WordProcessingSaveOptions(WordProcessingFormats.DOCX))

نحوه دریافت به‌روزرسانی

PyPI

نصب یا ارتقاء با استفاده از:

pip install groupdocs-editor-net

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

چرخ