TOML ke JSON

Pemetaan tipe

Keluaran selalu diformat dengan indentasi 4 spasi, sehingga array dan objek terbentang di beberapa baris; tabel di atas menampilkan nilai dalam satu baris agar mudah dibaca. Urutan kunci dipertahankan persis seperti di TOML Anda.

Contoh lengkap

title = "My App"

[server]
host = "localhost"
port = 8080

[[users]]
name = "alice"
admin = true

dikonversi menjadi:

{
    "title": "My App",
    "server": {
        "host": "localhost",
        "port": 8080
    },
    "users": [
        {
            "name": "alice",
            "admin": true
        }
    ]
}

TOML yang didukung dan batasan nyatanya

Didukung: header [tabel] termasuk nama bagian bertitik, [[array tabel]], pasangan key = value satu baris, string basic "..." dengan escape \n, \t, dan \", string literal '...', bilangan bulat dan desimal sederhana, true/false, array satu baris (boleh bersarang), komentar # satu baris penuh, serta tanggal yang diteruskan sebagai string.

Tidak didukung, beserta solusinya:

• String multibaris (""" atau ''') dan array multibaris menghentikan parser dengan galat. Letakkan dulu nilainya dalam satu baris.
• Tabel inline tidak diurai: point = { x = 1, y = 2 } keluar sebagai string "{ x = 1, y = 2 }", bukan objek. Tulis ulang sebagai bagian [point] tersendiri. Baris dependensi Cargo.toml seperti serde = { version = "1.0" } adalah kasus klasiknya.
• Kunci bertitik di sebelah kiri tanda sama dengan tetap menjadi satu kunci datar: server.host = "a" menghasilkan kunci "server.host", tanpa bersarang. Gunakan header [server] sebagai gantinya. Sebaliknya, [nama.bagian] bertitik di header bersarang dengan benar.
• Komentar setelah nilai tidak dibuang: port = 8080 # main menjadi string "8080 # main". Simpan komentar di barisnya sendiri.
• Format angka di luar desimal sederhana tidak dikenali: 1_000, 0xFF, 5e2, +99, inf, dan nan keluar sebagai string berkutip. Tulis 1000, 255, 500, 99.
• Escape \uXXXX dalam string basic tidak didekodekan. Tempelkan karakter aslinya saja.

Untuk dokumen TOML 1.0 yang lengkap, gunakan konverter baris perintah seperti toml2json, atau muat file dengan tomllib milik Python lalu keluarkan JSON dari sana.

Kapan alat ini berguna

• Memeriksa cepat potongan TOML sebagai JSON saat debugging.
• Meneruskan nilai konfigurasi sederhana ke linter, skrip, atau perkakas inventaris yang hanya menerima JSON.
• Membuat fixture JSON untuk pengujian dari catatan TOML yang lebih mudah ditulis tangan.
• Memigrasikan file konfigurasi kecil dan datar, seperti banyak config.toml milik Hugo.

Catatan bolak-balik

• Komentar tidak pernah selamat: JSON sama sekali tidak punya sintaksis komentar.
• Tanggal tetap string; kode di hilir harus mengurainya kembali menjadi objek tanggal.
• Angka besar: bilangan bulat disimpan sebagai nilai 64-bit dalam teks JSON, tetapi konsumen JavaScript kehilangan presisi di atas 2^53. Waspadai stempel waktu nanodetik dan ID numerik.
• Urutan kunci dipertahankan seperti aslinya oleh konverter ini; perkakas JSON lain bisa menyusun ulang kunci saat menuliskan kembali dokumen.

Arah sebaliknya

JSON → TOML adalah perjalanan yang lebih sulit, karena JSON punya struktur (persarangan anonim yang dalam, null) yang tidak dimiliki TOML atau ditangani secara berbeda. Sebagian besar skenario bolak-balik butuh penyesuaian manual di sisi TOML.