GroupDocs.Conversion for Python v26.3 זמין כעת. גרסה זו מוסיפה המרה לפי דף, פלט זרם בזיכרון, תמיכה ב‑Python 3.14, קבצי אינטגרציה של AI‑Agent, מטא‑נתוני פורמט משופרים, וכמה שיפורים.
מה חדש בגרסה זו
| מפתח | קטגוריה | סיכום |
|---|---|---|
| CONVERSIONPYTHON-65 | תכונה | המרה לפי דף באמצעות convert_by_page(output_dir, convert_options) |
| CONVERSIONPYTHON-66 | תכונה | המרה בזיכרון באמצעות convert_to_stream(convert_options) |
| CONVERSIONPYTHON-62 | תכונה | תמיכה ב‑Python 3.14 |
| CONVERSIONPYTHON-64 | תכונה | משלוח קובץ AGENTS.md בתוך החבילה לאינטגרציה של AI Agent |
| CONVERSIONPYTHON-67 | שיפור | אובייקטי פורמט חושפים את המאפיינים .extension, .file_format, .description |
| CONVERSIONPYTHON-68 | שיפור | מסווג macOS מפורש במטא‑נתוני PyPI |
שינויים בממשק ה‑API הציבורי
שיטות פונקציונליות חדשות – שיטות אלו הוגדרו ב‑25.12 אך העלו NotImplementedError. הן כעת פעילות:
| שיטה | מחזירה | תיאור |
|---|---|---|
Converter.convert_by_page(output_dir, convert_options) |
None |
מחלקת מסמך לקובץ אחד לכל דף בתיקייה הנתונה |
Converter.convert_to_stream(convert_options) |
bytes |
ממירה את המסמך ומחזירה את התוצאה כ‑bytes בזיכרון |
שיטות שעדיין אינן זמינות – השיטות הבאות קיימות כפרוקסי תכונות במחלקת Converter אך עדיין אינן פעילות בממשק Python. קריאה אליהן תגרום לחריגה:
| שיטה | סטטוס | פתרון חלופי |
|---|---|---|
convert_by_page(file_path, page_number, convert_options) |
TypeError — עומס של 3 ארגומנטים אינו חשוף |
השתמש ב‑convert_options.page_number + convert_options.pages_count = 1 עם convert(file_path, options) |
convert_by_page(stream, page_number, convert_options) |
TypeError — עומס של 3 ארגומנטים אינו חשוף |
המרה לקובץ, ואז קרא ל‑io.BytesIO |
convert_multiple(folder_path, convert_options) |
MissingMethodException |
השתמש ב‑convert(file_path, options) לקבלת פלט קובץ יחיד מאוחד מארכיונים |
תכונות חדשות
המרה לפי דף – convert_by_page
השיטה Converter.convert_by_page(output_dir, convert_options) היא כעת פעילה במלואה. היא מחלקת מסמך מרובה‑דפים לקבצי פלט נפרדים — קובץ אחד לכל דף — הנשמרים בתיקייה שצוינה. קבצי הדף נקראים page_1.ext, page_2.ext וכן הלאה. שיטה זו פועלת עבור כל מחלקות ConvertOptions התומכות בפלט מבוסס‑דף, כגון ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions ועוד.
המרה בזיכרון – convert_to_stream
השיטה Converter.convert_to_stream(convert_options) מחזירה כעת את המסמך המומר כאובייקט bytes של Python, מה שמאפשר צינורות המרה בזיכרון ללא כתיבה לדיסק. זה שימושי לפונקציות ענן, יישומי אינטרנט, וארכיטקטורות זרימה שבהן גישה למערכת הקבצים מוגבלת או לא רצויה.
תמיכה ב‑Python 3.14
טווח גרסאות ה‑Python הנתמך הורחב מ‑3.5–3.13 (25.12) ל‑3.5–3.14. מטא‑נתוני Requires-Python כעת מציגים >=3.5,<3.15, ודף ה‑PyPI מציין במפורש מסווגים עבור Python 3.8 עד 3.14.
AGENTS.md – אינטגרציה של AI Agent ו‑LLM
חבילת ה‑pip groupdocs-conversion כעת כוללת קובץ AGENTS.md ב‑groupdocs/conversion/AGENTS.md בתוך ה‑wheel. עוזרי קוד AI הסורקים חבילות מותקנות — כגון Claude Code, Cursor, ו‑GitHub Copilot — יכולים לגלות אוטומטית את ממשק ה‑API, דפוסי השימוש, נתיבי ה‑import, וטיפים לפתרון בעיות ללא הדרכה ידנית.
מאפייני אובייקט פורמט
אובייקטי פורמט המוחזרים על‑ידי get_possible_conversions() ו‑get_all_possible_conversions() מציגים כעת מאפיינים קריאים לבני אדם:
.extension– למשל'pdf'.file_format– למשל'Portable Document Format'.description– למשל'Portable Document Format File (pdf)'
לפני כן האובייקטים האלו הוצגו כ‑<NetObject handle=NNN> בלתי קריא; הם כעת מוצגים כ‑<NetObject pdf> ב‑repr() ומספקים ערכי מחרוזת נקיים דרך המאפיינים המופיעים למעלה.
דוגמת קוד
import os
from groupdocs.conversion import Converter
from groupdocs.conversion.filetypes import ImageFileType
from groupdocs.conversion.options.convert import ImageConvertOptions
output_dir = "./converted-pages"
os.makedirs(output_dir, exist_ok=True)
with Converter("./presentation.pptx") as converter:
options = ImageConvertOptions()
options.format = ImageFileType.PNG
converter.convert_by_page(output_dir, options)
# produces: page_1.png, page_2.png, ...
איך לקבל את העדכון
PyPI
pip install --upgrade groupdocs-conversion