Konverter Data

Satu pohon, enam format

Setiap konversi mengurai sumbernya menjadi satu pohon bertipe, lalu menuliskan pohon itu kembali dalam format tujuan. Itulah yang membuat perjalanan bolak-baliknya jujur: angka tetap angka, susunan bersarang tetap utuh, dan kunci objek mempertahankan urutan penulisannya alih-alih diam-diam diurutkan alfabetis. Itu juga sebabnya menambah format berarti satu parser dan satu serialiser, bukan kasus khusus baru untuk tiap pasangan.

Kelebihan masing-masing format

JSON

Format pertukaran bawaan. Menjaga susunan bersarang dan tipe data tetap utuh.

YAML

Ramah untuk konfigurasi dan komentar, meski komentarnya tidak ikut terbawa.

TOML

Butuh tabel di akar. Nilai null dibuang — TOML tidak mengenalnya.

CSV

Siap untuk spreadsheet. Butuh array objek; nilai bersarang menjadi sel JSON.

TSV

CSV dengan tab. Lebih aman kalau data Anda penuh koma.

JSONL

Satu dokumen per baris. Format yang dipakai pipeline log dan dataset LLM.

Sudut-sudut canggung yang ditangani secara sengaja

• CSV tidak punya tipe. Sebuah sel baru menjadi angka jika mencetak angka itu kembali menghasilkan teks aslinya persis, jadi 007 tetap string sementara 12 tidak.
• CSV tidak mengenal susunan bersarang. Menulis tabel dari data bersarang akan menyimpan nilai bersarang itu sebagai JSON di dalam sel, alih-alih mengarang skema perataan yang nanti harus Anda balikkan lagi.
• TOML tidak punya null. Kunci yang bernilai null dibuang, bukan menggagalkan seluruh dokumen, dan sumber yang bukan objek di akar ditolak langsung — TOML memerlukan tabel di sana.
• Komentar bukan data. Komentar YAML dan TOML hidup di luar pohon, jadi tidak bertahan melewati konversi. Tidak ada yang bisa membawanya ikut.

Pertanyaan yang sering diajukan

Bagaimana cara mengonversi JSON ke YAML, atau YAML ke JSON?

Tempel atau jatuhkan dokumennya, pastikan format masukan yang terdeteksi sudah benar, lalu pilih format keluarannya. Kedua arah melewati pohon bertipe yang sama, jadi susunan bersarang, angka, dan boolean tetap utuh.

Apakah konversi CSV ke JSON mempertahankan angka nol di depan?

Ya. Sebuah sel baru diubah menjadi angka jika mencetak angka itu kembali menghasilkan teks aslinya persis, jadi ID seperti 007 tetap berupa string "007" sementara 12 menjadi angka 12.

Apakah urutan kunci JSON saya dipertahankan?

Ya. Kunci objek mempertahankan urutan dokumen alih-alih diurutkan alfabetis, jadi keluarannya tetap enak dibandingkan (diff) dengan berkas sumber Anda.

Kenapa konversi saya ke TOML gagal?

TOML memerlukan tabel di tingkat teratas, jadi array atau nilai telanjang tidak bisa diwakili. TOML juga tidak punya null: kunci yang bernilai null dibuang alih-alih menggagalkan seluruh dokumen.

Apa itu JSONL, dan kapan sebaiknya dipakai?

JSONL — disebut juga NDJSON — menaruh satu dokumen JSON ringkas di tiap baris. Format inilah yang dipakai pipeline log dan dataset machine learning, karena pembacanya bisa mengalirkannya satu rekaman demi satu tanpa harus mengurai seluruh berkas lebih dulu.