JSON to TOML

Apa Itu Konversi JSON ke TOML?

Konversi JSON ke TOML mengubah data dari JavaScript Object Notation menjadi Tom's Obvious Minimal Language. JSON menggunakan kurung kurawal, kurung siku, dan kunci yang diberi tanda kutip untuk merepresentasikan data terstruktur. TOML menggunakan sintaks pasangan kunci-nilai yang datar dengan header bagian (disebut tabel) yang terbaca seperti file INI namun dengan pengetikan yang ketat. TOML dirancang khusus untuk file konfigurasi di mana keterbacaan oleh manusia lebih diutamakan daripada pertukaran data antar mesin.

TOML telah menjadi format konfigurasi default untuk Rust (Cargo.toml), pengemasan Python (pyproject.toml), situs statis Hugo, pengaturan deployment Netlify, dan banyak alat CLI. Ketika data sumber Anda ada dalam bentuk JSON — dari respons API, konfigurasi yang diekspor, atau file yang dibuat secara otomatis — dan sistem target Anda mengharapkan TOML, Anda memerlukan konverter yang memetakan objek JSON ke tabel TOML, array JSON ke array TOML, dan mempertahankan setiap tipe data secara akurat.

Mengonversi JSON ke TOML secara online adalah cara tercepat untuk menghasilkan TOML yang valid dari data JSON yang sudah ada. Konversi menangani pemetaan tipe secara otomatis: string JSON menjadi string TOML, angka JSON menjadi integer atau float TOML, boolean JSON dipetakan langsung, dan objek JSON menjadi tabel TOML. Satu pengecualian adalah null — TOML tidak memiliki tipe null, sehingga nilai null dihilangkan atau dikonversi menjadi string kosong tergantung konverternya.

Mengapa Menggunakan Konverter JSON ke TOML Ini?

TOML adalah format yang diharapkan oleh file konfigurasi; JSON adalah format yang dihasilkan oleh API dan alat. Konverter ini menjembatani kesenjangan tersebut sehingga Anda dapat memindahkan data antara kedua format tanpa penulisan ulang secara manual.

Kasus Penggunaan JSON ke TOML

Perbandingan JSON vs TOML

JSON dan TOML memiliki kemampuan yang tumpang tindih tetapi berbeda dalam sintaks, dukungan tipe, dan penggunaan yang dimaksudkan. Tabel ini menunjukkan perbedaan yang memengaruhi konversi.

Jebakan Konversi TOML

TOML memiliki aturan yang berbeda dari JSON dengan cara yang memengaruhi output konversi. Empat masalah ini paling sering menimbulkan kebingungan.

Contoh Kode

Mengonversi JSON ke TOML secara terprogram memerlukan library serialisasi TOML di sebagian besar bahasa. Library standar mem-parsing JSON; output TOML memerlukan paket khusus.

import { stringify } from '@iarna/toml'

const json = '{"title":"My App","database":{"host":"localhost","port":5432}}'
const obj = JSON.parse(json)
const toml = stringify(obj)
console.log(toml)
// → title = "My App"
// →
// → [database]
// → host = "localhost"
// → port = 5432

import json
import tomli_w  # pip install tomli_w

json_str = '{"title": "My App", "database": {"host": "localhost", "port": 5432}}'
data = json.loads(json_str)
toml_str = tomli_w.dumps(data)
print(toml_str)
# → title = "My App"
# →
# → [database]
# → host = "localhost"
# → port = 5432

package main

import (
    "encoding/json"
    "fmt"
    "github.com/pelletier/go-toml/v2"
)

func main() {
    jsonStr := `{"title":"My App","database":{"host":"localhost","port":5432}}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    tomlBytes, _ := toml.Marshal(data)
    fmt.Println(string(tomlBytes))
    // → title = 'My App'
    // →
    // → [database]
    // → host = 'localhost'
    // → port = 5432
}

# Using yj (https://github.com/sclevine/yj)
echo '{"title":"My App","port":3000}' | yj -jt
# → title = "My App"
# → port = 3000

# Using remarshal (pip install remarshal)
echo '{"title":"My App","port":3000}' | remarshal -if json -of toml
# → title = "My App"
# → port = 3000

Pertanyaan yang Sering Diajukan