GroupDocs.Conversion for Python 26.3 – ไฮไลท์การปล่อยเมษายน 2026

GroupDocs.Conversion for Python v26.3 มีให้ใช้งานแล้ว รุ่นนี้เพิ่มการแปลงต่อหน้า, การแปลงเป็นสตรีมในหน่วยความจำ, การสนับสนุน Python 3.14, ไฟล์การรวม AI‑agent, เมตาดาต้ารูปแบบที่ปรับปรุง, และการปรับแต่งหลายอย่าง

มีอะไรใหม่ในรุ่นนี้

คีย์	ประเภท	สรุป
CONVERSIONPYTHON-65	Feature	การแปลงต่อหน้าผ่าน `convert_by_page(output_dir, convert_options)`
CONVERSIONPYTHON-66	Feature	การแปลงในหน่วยความจำผ่าน `convert_to_stream(convert_options)`
CONVERSIONPYTHON-62	Feature	การสนับสนุน Python 3.14
CONVERSIONPYTHON-64	Feature	แพ็กเกจมาพร้อมไฟล์ AGENTS.md สำหรับการรวม AI Agent
CONVERSIONPYTHON-67	Enhancement	วัตถุ Format เปิดเผยคุณสมบัติ `.extension`, `.file_format`, `.description`
CONVERSIONPYTHON-68	Enhancement	เพิ่ม classifier macOS อย่างชัดเจนในเมตาดาต้า PyPI

การเปลี่ยนแปลง API สาธารณะ

เมธอดฟังก์ชันใหม่ – เมธอดเหล่านี้ประกาศใน 25.12 แต่เคยโยน NotImplementedError ตอนนี้ทำงานได้แล้ว:

เมธอด	คืนค่า	คำอธิบาย
`Converter.convert_by_page(output_dir, convert_options)`	`None`	แบ่งเอกสารเป็นไฟล์หนึ่งไฟล์ต่อหน้าในไดเรกทอรีที่ระบุ
`Converter.convert_to_stream(convert_options)`	`bytes`	แปลงเอกสารและคืนผลลัพธ์เป็นไบต์ในหน่วยความจำ

เมธอดที่ยังไม่พร้อมใช้งาน – เมธอดต่อไปนี้มีอยู่เป็นพร็อกซี่ของแอตทริบิวต์บนคลาส Converter แต่ ยังไม่ทำงาน ในไบด์ดิ้งของ Python การเรียกใช้จะโยนข้อยกเว้น:

เมธอด	สถานะ	วิธีแก้
`convert_by_page(file_path, page_number, convert_options)`	`TypeError` — 3‑arg overload ไม่ได้เปิดเผย	ใช้ `convert_options.page_number` + `convert_options.pages_count = 1` กับ `convert(file_path, options)`
`convert_by_page(stream, page_number, convert_options)`	`TypeError` — 3‑arg overload ไม่ได้เปิดเผย	แปลงเป็นไฟล์แล้วอ่านเข้า `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 แสดง classifier สำหรับ Python 3.8 ถึง 3.14 อย่างชัดเจน

AGENTS.md – การรวม AI Agent และ LLM
แพ็กเกจ groupdocs-conversion บน pip ตอนนี้มาพร้อมไฟล์ AGENTS.md ที่ตำแหน่ง groupdocs/conversion/AGENTS.md ภายใน wheel AI coding assistants ที่สแกนแพ็กเกจที่ติดตั้งไว้ — เช่น Claude Code, Cursor, และ GitHub Copilot — สามารถค้นพบ API, รูปแบบการใช้งาน, เส้นทางการ import, และเคล็ดลับการแก้ปัญหาโดยอัตโนมัติโดยไม่ต้องมีเอกสารแยก

คุณสมบัติของวัตถุ Format
วัตถุ Format ที่คืนจาก 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() และให้ค่า string ที่สะอาดผ่านคุณสมบัติดังกล่าว

ตัวอย่างโค้ด

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

มีอะไรใหม่ในรุ่นนี้#

การเปลี่ยนแปลง API สาธารณะ#

ฟีเจอร์ใหม่#

ตัวอย่างโค้ด#

วิธีอัปเดต#

PyPI#

แหล่งข้อมูล#