אנו שמחים להודיע על שחרור GroupDocs.Signature for Python v26.10, זמין החל מאוקטובר 2026. גרסה מרכזית זו מעדכנת את מנוע GroupDocs.Signature הבסיסי מ‑25.12 ל‑26.9 ומעבירה את זמן הריצה המוטמע של .NET מ‑.NET Core 3.1 ל‑.NET 10.0.12. היא מציגה קריאות חוזרות בסגנון Python עבור זרמי תצוגה מקדימה, רישום, הצפנת נתונים ותמיכה ב‑hash חתימה מותאם, מוסיפה תאימות מלאה ל‑Python 3.14, ופותרת בעיות ייבוא קריטיות ב‑Linux. גרסה זו כוללת שני תכונות מרכזיות, חמש שיפורים ושתי תיקוני באגים.
מה חדש בגרסה זו
- [Feature] קבלה של פונקציות Python כקריאות חוזרות לתצוגה מקדימה של דף וחתימה (SIGNATUREPYTHON-21)
- [Feature] קבלה של אובייקטים Python כמימושים של
ILogger,IDataEncryptionו‑ICustomSignHash(SIGNATUREPYTHON-22) - [Feature] הוספת תמיכה ב‑Python 3.14 (SIGNATUREPYTHON-23)
- [Enhancement] עדכון מנוע GroupDocs.Signature מ‑25.12 ל‑26.9 (SIGNATUREPYTHON-24)
- [Enhancement] עדכון זמן הריצה המוטמע של .NET מ‑.NET Core 3.1 ל‑.NET 10.0.12 (SIGNATUREPYTHON-25)
- [Enhancement] הקפת
GroupDocsSignatureException,IncorrectPasswordExceptionו‑PasswordRequiredExceptionבמקוםRuntimeError(SIGNATUREPYTHON-26) - [Enhancement] הקפת
AttributeErrorכאשר קוד מנסה להקצות תכונה שהמחלקה אינה מכילה (SIGNATUREPYTHON-27) - [Enhancement] שינוי שם של חברים שהשמות ב‑Python מחלקים מילים של .NET (
z_order→zorder,x_ad_es_type→xad_es_type) (SIGNATUREPYTHON-28) - [Enhancement] בחירת עומסים לפי תוכן של רשימה, והעברת ערכי
datetimeו‑Decimalל‑.NET ללא שינוי (SIGNATUREPYTHON-29) - [Enhancement] עדכון תגיות פלטפורמה של חבילת wheel ל‑
manylinux_2_27ו‑macosx_12_0, והסרת חבילת Windows 32‑bit (SIGNATUREPYTHON-30) - [Fix] חבילת ה‑Linux לא ניתנת לייבוא על הפצות נוכחיות (SIGNATUREPYTHON-31)
- [Fix]
GROUPDOCS_LIC_PATHמתעלם (SIGNATUREPYTHON-32)
שינויים ב‑API הציבורי
מעדכנים צריכים להתאים את עצמם לחברים ששונו שמם, לסוגי החריגים החדשים ולתגיות הפלטפורמה המעודכנות. הקצאת תכונות כעת מייצרת AttributeError והקריאות החוזרות יכולות להיות פונקציות Python רגילות.
מחלקות וחברים חדשים
groupdocs.signature:ProcessCompleteEventHandler,ProcessProgressEventHandler,ProcessStartEventHandler.groupdocs.signature.domain:OoxmlCompliance.groupdocs.signature.options:CreateSignatureStream,ReleaseSignatureStream,PreviewOptions.CreateDocPageStream,PreviewOptions.ReleaseDocPageStream,PreviewOptions.PreviewFormats,PreviewSignatureOptions.PreviewFormats.ConsoleLogger:error().DigitalSignOptions:allow_expired,allow_not_yet_valid.DigitalSignature:certificate_store_location,certificate_store_name.FileLogger:error().ILogger:error().ImageSignOptions:dispose().LoadOptions:skip_external_resources,whitelisted_resources.Mailmark2D:class_.MetadataSignatureCollection:append(),get().PreviewOptions: בונה (constructor); לא היה קיים לפני כן.PreviewSignatureOptions: בונה (constructor); לא היה קיים לפני כן.SearchResult:get_enumerator(),to_list().Signature:dispose().SignatureSettings:default_culture.WordProcessingSaveOptions:ooxml_compliance.
שונה שם
| מחלקה | שם ישן | שם חדש |
|---|---|---|
BarcodeTypes |
DATA_LOGIC_2OF_5 |
DATA_LOGIC_2OF5 |
BarcodeTypes |
GS1_CODE_128 |
GS1_CODE128 |
BarcodeTypes |
GS1_MICRO_PDF_417 |
GS1_MICRO_PDF417 |
BarcodeTypes |
IATA2OF_5 |
IATA2OF5 |
BarcodeTypes |
INTERLEAVED_2OF_5 |
INTERLEAVED_2OF5 |
BarcodeTypes |
MATRIX_2OF_5 |
MATRIX_2OF5 |
BarcodeTypes |
STANDARD_2OF_5 |
STANDARD_2OF5 |
BarcodeTypes |
UPCA_GS_1_CODE_128_COUPON |
UPCA_GS1_CODE_128_COUPON |
BarcodeTypes |
UPCA_GS_1_DATABAR_COUPON |
UPCA_GS1_DATABAR_COUPON |
DigitalSignature |
x_ad_es_type |
xad_es_type |
FileType |
G_ZIP |
GZIP |
FileType |
L_ZIP |
LZIP |
XAdESType |
X_AD_ES |
XAD_ES |
DigitalSignOptions |
x_ad_es_type |
xad_es_type |
JpegCompressionColorMode |
Y_CB_CR |
YCB_CR |
SignOptions |
z_order |
zorder |
PdfTextAnnotationAppearance |
h_corner_radius |
hcorner_radius |
PdfTextAnnotationAppearance |
v_corner_radius |
vcorner_radius |
תכונות חדשות
יצירת תצוגה מקדימה עם קריאות חוזרות של Python
PreviewOptions ניתן כעת לבנות עם פונקציות Python רגילות. קריאת ה‑create מקבלת אובייקט page_data וחייבת להחזיר זרם כתיבה (אובייקט קובץ או io.BytesIO). קריאת ה‑release מתבצעת לאחר שהתמונה נכתבה ומקבלת את אותו page_data והזרם.
from groupdocs.signature import Signature
from groupdocs.signature.options import PreviewOptions
def create_page_stream(page_data):
return open(f"page-{page_data.page_number}.png", "wb")
def release_page_stream(page_data, page_stream):
page_stream.close()
with Signature("document.pdf") as signature:
signature.generate_preview(PreviewOptions(create_page_stream, release_page_stream))
אובייקטים של Python כמחוללי לוג, הצפנה וקריאות חוזרות של hash מותאם
אובייקטים של Python יכולים כעת לממש את הממשקים ILogger, IDataEncryption, ו‑ICustomSignHash. ניתן להעביר אובייקט לוג עם שיטות trace, warning ו‑error ל‑SignatureSettings. אובייקט הצפנה עם שיטות encode ו‑decode ניתן לשייך ל‑options.data_encryption ב‑QR‑code או בחתימות מטא‑דטה. חותם hash מותאם יכול להיות פונקציה או אובייקט עם שיטת custom_sign_hash ומשמש ב‑DigitalSignOptions.custom_sign_hash.
import base64
from groupdocs.signature import Signature, SignatureSettings
from groupdocs.signature.options import QrCodeSignOptions
class SimpleLogger:
def trace(self, message):
print("TRACE:", message)
def warning(self, message):
print("WARN:", message)
def error(self, message, exception=None):
print("ERROR:", message, exception)
class Base64Encryption:
def encode(self, source):
return base64.b64encode(source.encode()).decode()
def decode(self, source):
return base64.b64decode(source).decode()
options = QrCodeSignOptions("Private text")
options.data_encryption = Base64Encryption()
with Signature("document.pdf", SignatureSettings(logger=SimpleLogger())) as signature:
signature.sign("signed.pdf", options)
תמיכה ב‑Python 3.14
חבילת ה‑wheel כעת מציינת python_requires=">=3.5,<3.15" וחבילה יחידה לכל פלטפורמה מכסה את Python 3.5 – 3.14. אין צורך בשינויים בקוד; הייבוא והשימוש זהים במפרש החדש.
דוגמת קוד
ראו את הסעיף “תכונות חדשות” למעלה לקבלת דוגמאות קוד עובדות המדגימות קריאות חוזרות של Python ליצירת תצוגה מקדימה ולמימושי לוג/הצפנה מותאמים.
איך לקבל את העדכון
PyPI
שדרגו לחבילה העדכנית ביותר של GroupDocs.Signature for Python דרך PyPI: groupdocs-signature-net 26.10.0
התקינו באמצעות:
pip install groupdocs-signature-net==26.10.0
הורדה ישירה
הורידו את חבילות ה‑wheel ישירות מ-דף השחרור של GroupDocs.Signature for Python v26.10.