ما خوشحالیم که انتشار 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.Colorgroupdocs.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) مربوط به پلتفرم خود را از اینجا دانلود کنید:
- GroupDocs.Redaction برای Python از طریق .NET 26.11 – ویندوز
- GroupDocs.Redaction برای Python از طریق .NET 26.11 – لینوکس
- GroupDocs.Redaction برای Python از طریق .NET 26.11 – macOS Intel
- GroupDocs.Redaction برای Python از طریق .NET 26.11 – macOS Apple Silicon