نحن سعداء بالإعلان عن إصدار 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.Colorgroupdocs.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 لمنصتك من:
- GroupDocs.Redaction for Python عبر .NET 26.11 – Windows
- GroupDocs.Redaction for Python عبر .NET 26.11 – Linux
- GroupDocs.Redaction for Python عبر .NET 26.11 – macOS Intel
- GroupDocs.Redaction for Python عبر .NET 26.11 – macOS Apple Silicon