Pipeline yang mengubah gambar hasil AI menjadi PPTX perlu diuji pada dua hal berbeda: apakah tampilannya sesuai harapan dan apakah isi presentasinya benar-benar dapat diedit. Golden file membantu menemukan regresi visual, sedangkan pemeriksaan struktur arsip dan invariant memverifikasi bahwa teks serta elemen penting tersimpan sebagai objek PowerPoint, bukan hanya bagian dari satu gambar.
Panduan ini menggunakan GordenSuperPPTSkills sebagai konteks proyek, bukan sebagai klaim tentang implementasi atau fiturnya. Strateginya berlaku untuk pipeline Python sejenis: siapkan masukan deterministik, periksa berkas PPTX, tetapkan aturan ketereditan, lalu bandingkan hasil render menggunakan lingkungan yang terkendali.
Pisahkan pemeriksaan struktur, ketereditan, dan visual
PPTX adalah paket Office Open XML yang berisi sejumlah bagian di dalam arsip ZIP. Pengujian yang hanya membuka berkas atau membandingkan tangkapan layar tidak membuktikan bahwa slide bisa diedit. Sebaliknya, memeriksa XML saja tidak memastikan hasil tampil dengan benar.
- Uji struktur: memastikan arsip dapat dibaca, bagian slide tersedia, dan dokumen memiliki jumlah slide yang diharapkan.
- Uji invariant: memastikan konten yang wajib dapat diedit direpresentasikan sebagai elemen PowerPoint, misalnya objek teks atau bentuk.
- Uji visual: merender presentasi dan membandingkan hasilnya dengan golden file yang disetujui.
Ketiga lapisan menjawab pertanyaan berbeda. Jalankan uji struktur dan invariant lebih dahulu karena biasanya lebih cepat dan memberi diagnosis yang lebih spesifik. Jalankan pemeriksaan visual setelah ekspor berhasil melewati pemeriksaan dasar.
Siapkan fixture input yang deterministik
Jangan memanggil model AI atau layanan eksternal saat menjalankan tes regresi biasa. Hasil generatif dapat berubah, memerlukan jaringan, atau bergantung pada konfigurasi layanan. Gunakan gambar, teks, dan konfigurasi kecil yang disimpan sebagai fixture. Dengan demikian, perubahan keluaran lebih mungkin berasal dari perubahan kode daripada perubahan masukan.
Contoh susunan sederhana:
tests/
fixtures/
brief.json
slide-01.png
golden/
slide-01.png
test_pptx_export.pyFixture sebaiknya mencakup kasus representatif, seperti teks pendek, teks panjang yang membungkus, karakter non-ASCII, dan satu atau lebih elemen gambar. Tetapkan ukuran slide, urutan slide, nama berkas, serta seluruh opsi ekspor yang memengaruhi hasil. Jika tahap AI harus diuji, simpan responsnya sebagai data rekaman atau ganti batas layanan dengan keluaran tetap; jangan mengandalkan respons langsung pada tes deterministik.
Golden file harus berasal dari keluaran yang telah diperiksa dan disetujui, bukan diperbarui otomatis setiap kali tes gagal. Simpan perubahan golden bersama perubahan kode, lalu tinjau perbedaannya agar pembaruan yang tidak disengaja tidak menyamarkan regresi.
Periksa struktur arsip PPTX
Modul standar Python zipfile dan xml.etree.ElementTree cukup untuk pemeriksaan dasar tanpa menambahkan dependensi. Contoh berikut memastikan arsip dapat dibaca, menemukan bagian slide, dan menghitung elemen teks di dalamnya. Sesuaikan namespace dan aturan konten dengan kontrak ekspor proyek.
from pathlib import Path
from zipfile import ZipFile
import xml.etree.ElementTree as ET
PPT_NS = "http://schemas.openxmlformats.org/presentationml/2006/main"
A_NS = "http://schemas.openxmlformats.org/drawingml/2006/main"
NS = {"p": PPT_NS, "a": A_NS}
def inspect_pptx(path: Path) -> list[dict[str, int]]:
with ZipFile(path) as archive:
bad_member = archive.testzip()
assert bad_member is None, f"Arsip ZIP rusak pada {bad_member}"
slide_paths = sorted(
name for name in archive.namelist()
if name.startswith("ppt/slides/slide") and name.endswith(".xml")
)
assert slide_paths, "Tidak ditemukan bagian slide"
result = []
for slide_path in slide_paths:
root = ET.fromstring(archive.read(slide_path))
result.append({
"text_shapes": len(root.findall(".//p:sp[.//a:t]", NS)),
"pictures": len(root.findall(".//p:pic", NS)),
})
return resultUntuk kontrak yang lebih ketat, periksa juga bahwa relasi yang dirujuk slide tersedia dan jenis kontennya masuk akal. Jangan menganggap nama berkas slide selalu berurutan tanpa celah sebagai aturan universal; tetapkan aturan itu hanya jika memang bagian dari kontrak pembuat presentasi. Penghitungan langsung seperti di atas cocok untuk tes dasar, tetapi bukan pengganti parser OOXML lengkap jika tes perlu memvalidasi relasi yang kompleks.
Tetapkan invariant ketereditan yang bermakna
Ketereditan bukan sekadar keberadaan berkas slide.xml. Tetapkan invariant berdasarkan cara presentasi seharusnya digunakan. Jika teks judul wajib dapat diedit, pastikan teks itu muncul sebagai teks dalam objek slide. Jika gambar AI hanya berfungsi sebagai ilustrasi, pastikan gambar tersebut tidak menggantikan seluruh konten yang seharusnya berupa teks atau bentuk.
Contoh aturan yang dapat diuji:
- Jumlah slide sama dengan jumlah yang diminta untuk fixture.
- Setiap slide memiliki setidaknya satu objek teks yang diwajibkan oleh skenario.
- Setiap judul yang diketahui muncul sebagai teks pada slide yang benar.
- Gambar hanya digunakan pada slide yang memang memilikinya dalam masukan.
Gunakan ekspektasi khusus per fixture. Aturan global seperti “setiap slide harus memiliki gambar” akan menghasilkan tes rapuh jika ada slide yang memang tidak membutuhkannya. Demikian juga, jumlah bentuk yang persis dapat berubah karena perubahan tata letak yang sah. Lebih baik memeriksa hasil yang berpengaruh bagi pengguna, seperti teks penting yang tetap dapat dipilih dan diedit.
Nama tes juga perlu menyatakan invariant yang dilindungi. Misalnya, test_required_titles_remain_editable lebih informatif daripada test_output. Saat invariant gagal, tampilkan nama slide dan teks atau elemen yang hilang agar diagnosis tidak berhenti pada pesan “hasil berbeda”.
Gunakan golden file untuk regresi visual
Golden file visual biasanya berupa gambar hasil render setiap slide. Bandingkan gambar aktual dengan gambar acuan menggunakan alat pembanding yang sudah tersedia di lingkungan proyek. Pemeriksaan dapat memakai perbandingan piksel atau metrik kemiripan gambar, tetapi ambang toleransi harus ditetapkan berdasarkan kebutuhan: toleransi besar dapat melewatkan regresi, sedangkan toleransi terlalu ketat memunculkan kegagalan akibat variasi render kecil.
Render harus memakai aplikasi dan konfigurasi yang konsisten. Perbedaan versi mesin render, font, sistem operasi, atau pustaka gambar dapat mengubah tata letak dan antialiasing tanpa perubahan pada isi PPTX. Dalam CI, gunakan lingkungan yang dipatok dan font yang tersedia secara eksplisit. Jalankan renderer yang sama secara lokal bila memungkinkan.
Periksa berkas gambar berdampingan atau buat diff visual saat tes gagal. Jika perubahan hanya berupa variasi tepi huruf, selidiki lingkungan render sebelum mengubah golden. Jika posisi, ukuran, teks, atau gambar berubah, telusuri perubahan kode ekspor dan fixture. Jangan menaikkan ambang toleransi sekadar untuk membuat tes lulus.
Alur verifikasi lokal dan CI
Verifikasi lokal
- Jalankan tes struktur dan invariant terhadap fixture deterministik.
- Ekspor PPTX ke direktori sementara, lalu render setiap slide dengan renderer yang digunakan proyek.
- Bandingkan hasil render dengan golden file dan tinjau diff jika ada.
- Buka hasil PPTX di aplikasi presentasi untuk pemeriksaan manual terarah, terutama setelah perubahan besar pada ekspor atau tata letak.
Verifikasi CI
CI dapat menjalankan tes struktur dan invariant pada setiap perubahan. Jalankan tes golden dalam lingkungan render yang konsisten, lalu simpan gambar aktual dan diff sebagai artefak ketika tes gagal. Artefak tersebut memudahkan peninjauan tanpa membuat tes bergantung pada mesin pengembang. Pisahkan kegagalan lingkungan, seperti font atau renderer yang tidak tersedia, dari kegagalan konten; laporkan keduanya dengan jelas.
Pemeriksaan manual tetap berguna untuk kasus visual yang sulit dinilai otomatis, tetapi tidak menggantikan tes deterministik. Tes otomatis memberikan sinyal regresi yang dapat diulang; pemeriksaan manual menilai apakah perubahan visual yang disengaja memang dapat diterima.
Batasan dan diagnosis saat tes gagal
- Arsip atau XML gagal dibaca: periksa apakah proses ekspor selesai, apakah berkas terpotong, dan apakah keluaran yang diuji benar-benar berkas PPTX.
- Invariant teks gagal: periksa apakah teks hilang, berubah, atau diratakan menjadi gambar. Pastikan ekspektasi fixture sesuai dengan kontrak slide.
- Struktur lulus, golden gagal: bandingkan gambar aktual dengan golden. Periksa font, versi renderer, skala render, serta perubahan tata letak.
- Hanya CI yang gagal: cocokkan versi dependensi, font, dan konfigurasi renderer; lampirkan keluaran render aktual sebagai artefak.
- Golden berubah terlalu sering: periksa nondeterminisme pada urutan elemen, masukan eksternal, waktu, atau konfigurasi ekspor sebelum mengubah acuan.
Golden file tidak membuktikan bahwa presentasi dapat diedit, dan pemeriksaan XML tidak membuktikan tampilan yang benar. Gabungkan keduanya dengan invariant yang terkait kebutuhan pengguna. Untuk pipeline seperti yang dibangun dalam konteks GordenSuperPPTSkills, pendekatan ini memberi dasar yang dapat diulang untuk memeriksa keluaran tanpa menganggap perilaku proyek tertentu sebelum memverifikasinya.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!