אנחנו שמחים להודיע על השקת GroupDocs.Redaction for Python v26.11, זמינה החל מ-נובמבר 2026. גרסה זו משדרגת את מנוע GroupDocs.Redaction מ‑26.5 ל‑26.10 ומשלבת זמן ריצה של .NET 10.0.15, מחליפה את System.Drawing ב‑Aspose.Drawing וב‑SkiaSharp לצורך רסטריזציה חוצת‑פלטפורמות והסתרת אזורי‑תמונה—כולל Linux ו‑macOS. תכונות חדשות כוללות תצוגות מקדימות של דפים, תמיכה ברשימת רישום (logger) של Python, אינטגרציה של מחבר OCR של Python, שליטה ברמת התאימות של OOXML למסמכי Word, טעינת סוג קובץ מפורשת ובדיקה של מצב הרישיון.

מה חדש בגרסה זו

  • [תכונה] הוספת תמיכה בתצוגות מקדימות של דפים לקבצים ול‑io.BytesIO (PreviewOptions, generate_preview()) (REDACTIONPYTHONNET-23)
  • [תכונה] הוספת תמיכה ברשימת רישום (logger) של Python (ILogger) (REDACTIONPYTHONNET-24)
  • [תכונה] הוספת תמיכה במחבר OCR של Python (IOcrConnector) להסתרת טקסט בתמונות (REDACTIONPYTHONNET-25)
  • [תכונה] הוספת תמיכה בהגדרת רמת התאימות של OOXML למסמך Word שמור (ooxml_compliance) (REDACTIONPYTHONNET-26)
  • [תכונה] הוספת תמיכה בפתיחת מסמך כסוג קובץ נתון (LoadOptions.file_type) (REDACTIONPYTHONNET-27)
  • [תכונה] הוספת תמיכה בבדיקה האם רישיון הוחל (License.is_licensed) (REDACTIONPYTHONNET-28)
  • [שיפור] עדכון GroupDocs.Redaction ל‑26.10 ולזמן הריצה המשולב ל‑.NET 10.0.15 (REDACTIONPYTHONNET-29)
  • [שיפור] החלפת סוגי groupdocs.pydrawing ב‑groupdocs.redaction.options.drawing (Color, Point, Size, Rectangle, Font, FontStyle) (REDACTIONPYTHONNET-30)
  • [שיפור] החזרת המונים RedactionType ו‑RedactionActionType מתיאור של קריאת חזרה (callback) של הסתרה (REDACTIONPYTHONNET-31)
  • [שיפור] להקפיץ AttributeError כאשר מאפיין לא ידוע מוקצה לאובייקט API (REDACTIONPYTHONNET-32)
  • [שיפור] להקפיץ LicenseError עבור רישיון שלא ניתן להחיל, ולייצא אותו ואת GroupDocsRedactionException מ‑groupdocs.redaction (REDACTIONPYTHONNET-33)
  • [שיפור] להתקין groupdocs.pydrawing ו‑groupdocs.pycore מהחבילה המשותפת groupdocs-shared-net (REDACTIONPYTHONNET-34)
  • [תיקון] תיקון ממצאי CVE ב‑26.6.0: זמן ריצה של .NET 10.0.0 → 10.0.15 (+2 נוספים) (REDACTIONPYTHONNET-12)
  • [תיקון] פלט PDF מרסטר והסתרת אזור‑תמונה גורמים ל‑PlatformNotSupportedException ב‑Linux וב‑macOS (REDACTIONPYTHONNET-35)
  • [תיקון] קריאת חזרה (callback) של הסתרה נכשלת עם JSONDecodeError בטקסט שמכיל טאב (REDACTIONPYTHONNET-36)
  • [תיקון] RedactorSettings מקפיצה TypeError עבור קריאת חזרה של הסתרה שהועברה כארגומנט היחיד שלה (REDACTIONPYTHONNET-37)
  • [תיקון] החבילות (Wheels) מותקנות ב‑Linux וב‑macOS בגרסאות שהזמן ריצה המשולב של .NET אינו יכול לפעול עליהן (REDACTIONPYTHONNET-38)

שינויים ב‑API הציבורי

מעדכנים צריכים לייבא צבעים וגאומטריה מ‑groupdocs.redaction.options.drawing, ולהשוות את redaction_type ו‑action_type של קריאת חזרה (callback) של הסתרה עם חברי המונה. כל השאר הוא תוספת.

מחלקות וחברים חדשים

  • 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.

רשימת רישום (logger) של 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 לפלטפורמה שלכם מ‑:

משאבים