GroupDocs.Conversion for Python v26.3 พร้อมให้ใช้งานแล้ว รุ่นนี้เพิ่มการแปลงแบบต่อหน้า, การแปลงเป็นสตรีมในหน่วยความจำ, การสนับสนุน Python 3.14, ไฟล์การรวม AI‑agent, เมตาดาต้ารูปแบบที่ปรับปรุง, และการปรับแต่งหลายอย่าง
What’s new in this release
| คีย์ | ประเภท | สรุป |
|---|---|---|
| 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 | การปรับปรุง | ระบุ classifier ของ macOS อย่างชัดเจนในเมตาดาต้า PyPI |
Public API changes
New Functional Methods – these methods were declared in 25.12 but raised NotImplementedError. They are now operational:
| เมธอด | ผลลัพธ์ | คำอธิบาย |
|---|---|---|
Converter.convert_by_page(output_dir, convert_options) |
None |
แยกเอกสารเป็นไฟล์หนึ่งไฟล์ต่อหน้าในไดเรกทอรีที่ระบุ |
Converter.convert_to_stream(convert_options) |
bytes |
แปลงเอกสารและส่งคืนผลลัพธ์เป็นไบต์ในหน่วยความจำ |
Methods Not Yet Available – the following methods exist as attribute proxies on the Converter class but are not yet functional in the Python binding. Calling them will raise an exception:
| เมธอด | สถานะ | วิธีแก้ไข |
|---|---|---|
convert_by_page(file_path, page_number, convert_options) |
TypeError — ไม่ได้เปิดเผย overload ที่รับ 3 อาร์กิวเมนต์ |
ใช้ convert_options.page_number + convert_options.pages_count = 1 พร้อมกับ convert(file_path, options) |
convert_by_page(stream, page_number, convert_options) |
TypeError — ไม่ได้เปิดเผย overload ที่รับ 3 อาร์กิวเมนต์ |
แปลงเป็นไฟล์แล้วอ่านเข้า io.BytesIO |
convert_multiple(folder_path, convert_options) |
MissingMethodException |
ใช้ convert(file_path, options) เพื่อให้ได้ผลลัพธ์เป็นไฟล์เดียวที่รวมจากไฟล์อาร์ไคฟ์ |
New features
Per‑Page Conversion – convert_by_page
เมธอด Converter.convert_by_page(output_dir, convert_options) ตอนนี้ทำงานเต็มรูปแบบแล้ว มันจะแยกเอกสารหลายหน้าออกเป็นไฟล์ผลลัพธ์แยกแต่ละหน้า — หนึ่งไฟล์ต่อหน้า — และบันทึกลงในไดเรกทอรีที่ระบุ ไฟล์แต่ละหน้าจะมีชื่อ page_1.ext, page_2.ext เป็นต้น เมธอดนี้ทำงานกับคลาส ConvertOptions ทั้งหมดที่รองรับการส่งออกแบบต่อหน้า เช่น ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions และอื่น ๆ
In‑Memory Conversion – convert_to_stream
เมธอด Converter.convert_to_stream(convert_options) ตอนนี้ส่งคืนเอกสารที่แปลงแล้วเป็นอ็อบเจ็กต์ bytes ของ Python ทำให้สามารถสร้างสายงานการแปลงในหน่วยความจำได้โดยไม่ต้องเขียนลงดิสก์ ซึ่งเหมาะกับฟังก์ชันคลาวด์, แอปพลิเคชันเว็บ, และสถาปัตยกรรมสตรีมที่การเข้าถึงไฟล์ระบบจำกัดหรือไม่ต้องการ
Python 3.14 Support
ช่วงเวอร์ชัน Python ที่รองรับได้ขยายจาก 3.5–3.13 (25.12) เป็น 3.5–3.14 เมตาดาต้า Requires-Python ตอนนี้ระบุเป็น >=3.5,<3.15 และหน้าที่ PyPI แสดง classifier สำหรับ Python 3.8 ถึง 3.14 อย่างชัดเจน
AGENTS.md – AI Agent and LLM Integration
แพ็กเกจ groupdocs-conversion บน pip ตอนนี้รวมไฟล์ AGENTS.md ที่ตำแหน่ง groupdocs/conversion/AGENTS.md ภายใน wheel ผู้ช่วยเขียนโค้ด AI ที่สแกนแพ็กเกจที่ติดตั้งไว้ — เช่น Claude Code, Cursor, และ GitHub Copilot — สามารถค้นพบ API, รูปแบบการใช้งาน, เส้นทางการนำเข้า, และเคล็ดลับการแก้ปัญหาโดยอัตโนมัติโดยไม่ต้องอ้างอิงคู่มือเพิ่มเติม
Format Object Properties
อ็อบเจ็กต์รูปแบบที่คืนจาก 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() และให้ค่าข้อความที่สะอาดผ่านคุณสมบัติดังกล่าว
Code example
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, ...
How to get the update
PyPI
pip install --upgrade groupdocs-conversion