نحن سعداء بالإعلان عن إصدار 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] إرجاع تعداد 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 (+2 أخرى) (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 لرد الاتصال بالإخفاء مع أعضاء التعداد. كل شيء آخر إضافي.

الفئات والأعضاء الجديدة

  • 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 (لا يوجد تحميل متطابق).
  • 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 يأخذ دالة تُعيد تدفقًا لكل صفحة، أو ملفًا ثنائيًا مفتوحًا أو io.BytesIO، ويمكن اختياريًا دالة ثانية تُفرج عن تدفق كل صفحة. اضبط 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 من TextLines من TextFragments، كل منها يحتوي على نصه ومستطيله. ثم يجد المحرك العبارات في الصورة ويرسم فوقها. أبلغ عن كل سطر نص كـ 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) يفتح تدفقًا، أو ملفًا لا يُظهر اسمه تنسيقه، كـ 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 لمنصتك من:

الموارد