GroupDocs.Conversion for Python v26.3 artık kullanılabilir. Bu sürüm, sayfa‑sayfa dönüştürme, bellek içi akış çıktısı, Python 3.14 desteği, AI‑ajan entegrasyon dosyaları, geliştirilmiş format meta verileri ve çeşitli iyileştirmeler ekler.

Bu sürümdeki yenilikler

Anahtar Kategori Özet
CONVERSIONPYTHON-65 Özellik convert_by_page(output_dir, convert_options) ile sayfa‑sayfa dönüştürme
CONVERSIONPYTHON-66 Özellik convert_to_stream(convert_options) ile bellek içi dönüştürme
CONVERSIONPYTHON-62 Özellik Python 3.14 desteği
CONVERSIONPYTHON-64 Özellik AI Agent entegrasyonu için paket içinde AGENTS.md dosyası
CONVERSIONPYTHON-67 Geliştirme Format nesneleri .extension, .file_format, .description özelliklerini ortaya çıkar
CONVERSIONPYTHON-68 Geliştirme PyPI meta verilerinde açık macOS sınıflandırıcısı

Genel API değişiklikleri

Yeni Fonksiyonel Metodlar – bu metodlar 25.12 sürümünde tanımlanmış ancak NotImplementedError fırlatıyordu. Şimdi çalışır durumda:

Metod Dönüş Değeri Açıklama
Converter.convert_by_page(output_dir, convert_options) None Belirtilen dizine sayfa başına bir dosya olacak şekilde belgeyi böler
Converter.convert_to_stream(convert_options) bytes Belgeyi dönüştürür ve sonucu bellek içi bayt dizisi olarak döndürür

Henüz Kullanılamayan Metodlar – aşağıdaki metodlar Converter sınıfında öznitelik vekilleri olarak bulunur ancak Python bağlamında henüz işlevsel değildir. Çağrıldıklarında bir istisna fırlatılır:

Metod Durum Geçici Çözüm
convert_by_page(file_path, page_number, convert_options) TypeError — 3‑argüman aşırı yüklemesi sunulmadı convert_options.page_number + convert_options.pages_count = 1 ile convert(file_path, options) kullanın
convert_by_page(stream, page_number, convert_options) TypeError — 3‑argüman aşırı yüklemesi sunulmadı Dosyaya dönüştürün, ardından io.BytesIO içine okuyun
convert_multiple(folder_path, convert_options) MissingMethodException Arşivlerden tek bir dosya çıktısı almak için convert(file_path, options) kullanın

Yeni özellikler

Sayfa‑Sayfa Dönüştürme – convert_by_page
Converter.convert_by_page(output_dir, convert_options) metodu artık tam olarak çalışmaktadır. Çok sayfalı bir belgeyi, belirtilen dizine kaydedilen sayfa başına bir dosya olacak şekilde böler. Sayfa dosyaları page_1.ext, page_2.ext şeklinde adlandırılır. Bu metod, ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions ve benzeri sayfa‑tabanlı çıktı destekleyen tüm ConvertOptions sınıfları için geçerlidir.

Bellek İçi Dönüştürme – convert_to_stream
Converter.convert_to_stream(convert_options) metodu, dönüştürülmüş belgeyi bir Python bytes nesnesi olarak döndürür; böylece diske yazmadan bellek içi dönüşüm hatları oluşturulabilir. Bu, dosya sistemi erişiminin sınırlı veya istenmediği bulut fonksiyonları, web uygulamaları ve akış mimarileri için faydalıdır.

Python 3.14 Desteği
Desteklenen Python sürüm aralığı 3.5–3.13 (25.12) yerine 3.5–3.14 olarak genişletildi. Requires-Python meta verisi artık >=3.5,<3.15 şeklindedir ve PyPI sayfası Python 3.8‑den 3.14‑e kadar sınıflandırıcıları açıkça listeler.

AGENTS.md – AI Agent ve LLM Entegrasyonu
groupdocs-conversion pip paketi artık tekerleğin içinde groupdocs/conversion/AGENTS.md yolunda bir AGENTS.md dosyası içerir. Claude Code, Cursor ve GitHub Copilot gibi kurulu paketleri tarayan AI kod asistanları, API yüzeyini, kullanım örneklerini, içe aktarma yollarını ve sorun giderme ipuçlarını manuel rehber olmadan otomatik keşfedebilir.

Format Nesnesi Özellikleri
get_possible_conversions() ve get_all_possible_conversions() tarafından döndürülen format nesneleri artık okunabilir özellikler sunar:

  • .extension – örn. 'pdf'
  • .file_format – örn. 'Portable Document Format'
  • .description – örn. 'Portable Document Format File (pdf)'

Daha önce bu nesneler <NetObject handle=NNN> gibi opak bir biçimde gösteriliyordu; artık repr() içinde <NetObject pdf> olarak görünür ve yukarıdaki özellikler aracılığıyla temiz string değerleri sağlar.

Kod örneği

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)
    # üretir: page_1.png, page_2.png, ...

Güncellemeyi nasıl alabilirsiniz

PyPI

pip install --upgrade groupdocs-conversion

Kaynaklar