ما خوشحالیم که انتشار GroupDocs.Redaction for Python v26.11 را اعلام می‌کنیم که از نوامبر 2026 در دسترس است. این نسخه موتور GroupDocs.Redaction را از 26.5 به 26.10 ارتقا می‌دهد و زمان اجرا .NET 10.0.15 را تعبیه می‌کند، جایگزین System.Drawing با Aspose.Drawing و SkiaSharp برای رستر‌سازی چندپلتفرمی و حذف ناحیه تصویر می‌شود — شامل Linux و macOS. ویژگی‌های جدید شامل پیش‌نمایش صفحات، پشتیبانی از لاگر Python، یکپارچه‌سازی کانکتور OCR Python، کنترل سازگاری OOXML برای اسناد Word، بارگذاری صریح نوع فایل، و بررسی وضعیت لایسنس است.

چه چیزهای جدیدی در این نسخه وجود دارد

  • [Feature] افزودن پشتیبانی از پیش‌نمایش صفحات برای فایل‌ها و io.BytesIO (PreviewOptions, generate_preview()) (REDACTIONPYTHONNET-23)
  • [Feature] افزودن پشتیبانی از لاگر Python (ILogger) (REDACTIONPYTHONNET-24)
  • [Feature] افزودن پشتیبانی از کانکتور OCR Python (IOcrConnector) برای حذف متن در تصاویر (REDACTIONPYTHONNET-25)
  • [Feature] افزودن پشتیبانی از تنظیم سطح سازگاری OOXML یک سند Word ذخیره‌شده (ooxml_compliance) (REDACTIONPYTHONNET-26)
  • [Feature] افزودن پشتیبانی از باز کردن سند به عنوان یک نوع فایل مشخص (LoadOptions.file_type) (REDACTIONPYTHONNET-27)
  • [Feature] افزودن پشتیبانی از بررسی اینکه آیا لایسنس اعمال شده است (License.is_licensed) (REDACTIONPYTHONNET-28)
  • [Enhancement] به‌روزرسانی GroupDocs.Redaction به 26.10 و زمان اجرا تعبیه‌شده به .NET 10.0.15 (REDACTIONPYTHONNET-29)
  • [Enhancement] جایگزینی انواع groupdocs.pydrawing با groupdocs.redaction.options.drawing (Color, Point, Size, Rectangle, Font, FontStyle) (REDACTIONPYTHONNET-30)
  • [Enhancement] بازگرداندن مقادیر enumهای RedactionType و RedactionActionType از توضیح‌گر یک فراخوانی حذف (REDACTIONPYTHONNET-31)
  • [Enhancement] پرتاب AttributeError هنگام اختصاص یک ویژگی ناشناخته به یک شیء API (REDACTIONPYTHONNET-32)
  • [Enhancement] پرتاب LicenseError برای لایسنس غیرقابل اعمال، و صادرات آن و GroupDocsRedactionException از groupdocs.redaction (REDACTIONPYTHONNET-33)
  • [Enhancement] نصب groupdocs.pydrawing و groupdocs.pycore از بسته مشترک groupdocs-shared-net (REDACTIONPYTHONNET-34)
  • [Fix] رفع مشکلات CVE در 26.6.0: زمان اجرا .NET 10.0.0 → 10.0.15 (+۲ مورد دیگر) (REDACTIONPYTHONNET-12)
  • [Fix] خروجی PDF رستر‌شده و حذف ناحیه تصویر باعث پرتاب PlatformNotSupportedException در Linux و macOS می‌شد (REDACTIONPYTHONNET-35)
  • [Fix] یک فراخوانی حذف با JSONDecodeError در متنی که شامل تب است، شکست می‌خورد (REDACTIONPYTHONNET-36)
  • [Fix] RedactorSettings برای یک فراخوانی حذف که به‌عنوان تنها آرگومان پاس داده می‌شود، TypeError پرتاب می‌کند (REDACTIONPYTHONNET-37)
  • [Fix] بسته‌های Wheel در نسخه‌های Linux و macOS که زمان اجرا .NET تعبیه‌شده نمی‌تواند روی آن اجرا شود، نصب می‌شوند (REDACTIONPYTHONNET-38)

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

به‌روزرسانی‌کنندگان باید رنگ‌ها و هندسه را از groupdocs.redaction.options.drawing وارد کنند و برای مقایسه redaction_type و action_type یک فراخوانی حذف، با اعضای enum مقایسه کنند. بقیه موارد افزایشی هستند.

کلاس‌ها و اعضای جدید

  • groupdocs.redaction: CancellationToken, CancellationTokenSource, OperationCanceledError, LicenseError, LicenseWarning, GroupDocsRedactionException.
  • groupdocs.redaction.options: WordProcessingComplianceLevel, WordprocessingSaveOptions.
  • groupdocs.redaction.options.drawing: Color, Font, FontStyle, Point, Rectangle, Size.
  • FileType: DJVU, LOG, OTP, POTM, POTX, PPS, PPSM, PPSX, PPTM, TAB, WEBP, XLT, XLTM, XLTX.
  • License: is_licensed.
  • LoadOptions: file_type.
  • SaveOptions: wordprocessing_save_options.

groupdocs.redaction.options.drawing یک ماژول جدید است. GroupDocsRedactionException همچنان توسط groupdocs.redaction.exceptions نیز صادر می‌شود.

حذف شده

رنگ groupdocs.pydrawing که در 26.6 بازصادر می‌شد؛ به‌جای آن Color را از groupdocs.redaction.options.drawing وارد کنید:

  • groupdocs.redaction.Color
  • groupdocs.redaction.redactions.Color

تغییر یافته

  • هر عضوی که رنگ، نقطه، اندازه یا مستطیل می‌گیرد یا برمی‌گرداند، از انواع groupdocs.redaction.options.drawing استفاده می‌کند. مقدار groupdocs.pydrawing باعث پرتاب TypeError می‌شود (هیچ overloadی مطابقت ندارد).
  • RedactionDescription.redaction_type و action_type که یک فراخوانی حذف می‌خواند، اعضای RedactionType و RedactionActionType هستند.
  • نام‌های مستعار منسوخ شده موتور نیز موجود هستند: ReplacementOptions.box_fill_color, RegionReplacementOptions.area_fill_color و area_size, ImageAreaRedaction.top_left_position, PageAreaFilter.area_rectangle و TextFragment.bounding_rectangle. از box_color, fill_color, size, top_left و rectangle استفاده کنید.

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

پیش‌نمایش صفحات

Redactor.generate_preview() صفحات سند را به تصویر رندر می‌کند. PreviewOptions تابعی می‌گیرد که برای هر صفحه یک stream برمی‌گرداند، یک فایل باینری باز یا یک io.BytesIO، و به‌صورت اختیاری تابع دوم که stream هر صفحه را آزاد می‌کند. width، height و page_numbers را تنظیم کنید. در 26.6.0 یک تابع Python با TypeError رد شد.

لاگر Python

RedactorSettings(logger=...) شیئی را می‌گیرد که دارای متدهای error(message), warning(message) و trace(message) باشد و موتور از طریق آن گزارش می‌دهد. در 26.6.0 لاگر Python با TypeError رد شد.

کانکتور OCR Python

GroupDocs.Redaction هیچ موتور OCRی ارائه نمی‌دهد. RedactorSettings(ocr_connector=...) شیئی را می‌گیرد که متد recognize(image_stream) داشته باشد و آنچه موتور OCR شما پیدا کرده است برگرداند: یک RecognizedImage از TextLineهای TextFragment، هر کدام با متن و مستطیل خود. سپس موتور عبارات را در تصویر پیدا کرده و روی آن‌ها رنگ می‌زند. هر خط متن را به‌عنوان یک TextFragment گزارش کنید. در 26.6.0 یک کانکتور Python با TypeError رد شد.

سطح سازگاری OOXML یک سند Word ذخیره‌شده

SaveOptions.wordprocessing_save_options.ooxml_compliance سطح سازگاری OOXML یک سند Word ذخیره‌شده را تنظیم می‌کند: WordProcessingComplianceLevel.ECMA, TRANSITIONAL یا STRICT. اگر تنظیم نشود، سند سطح قبلی خود را حفظ می‌کند. در 26.6.0 این ویژگی وجود نداشت.

باز کردن سند به عنوان یک نوع فایل مشخص

LoadOptions(file_type) یک stream یا فایلی که نام آن فرمتش را نشان نمی‌دهد، به‌عنوان FileType داده‌شده باز می‌کند. در 26.6.0 این ویژگی وجود نداشت.

بررسی اینکه آیا لایسنس اعمال شده است

License().is_licensed پس از اعمال لایسنس، True می‌شود؛ با License().set_license() یا از متغیر محیطی GROUPDOCS_LIC_PATH.

مثال کد

import io
from groupdocs.redaction import Redactor
from groupdocs.redaction.options import PreviewOptions, PreviewFormats

pages = {}

def create_page_stream(page_number):
    pages[page_number] = io.BytesIO()
    return pages[page_number]

with Redactor("document.pdf") as redactor:
    options = PreviewOptions(create_page_stream)
    options.width, options.height = 300, 400
    options.page_numbers = [1]
    options.preview_format = PreviewFormats.PNG
    redactor.generate_preview(options)

print(len(pages[1].getvalue()), "bytes of PNG")

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

PyPI

به‌روزرسانی از طریق PyPI:

نصب با:

pip install groupdocs-redaction-net==26.11.0

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

چرخ (wheel) مربوط به پلتفرم خود را از اینجا دانلود کنید:

منابع