TOML to JSON

Apa itu Konversi TOML ke JSON?

TOML (Tom's Obvious Minimal Language) adalah format file konfigurasi yang dirancang untuk manusia. Format ini dipetakan secara jelas ke dalam hash table, mendukung tabel bertingkat, nilai bertipe, dan komentar inline. Banyak alat dan framework menggunakan TOML sebagai format konfigurasi utama mereka: proyek Rust mengandalkan Cargo.toml, pengemasan Python menggunakan pyproject.toml, dan situs statis Hugo dikonfigurasi melalui config.toml. Mengonversi TOML ke JSON secara online memungkinkan Anda mengubah file konfigurasi ini menjadi format yang dapat dikonsumsi secara native oleh hampir setiap bahasa pemrograman, API, dan pipeline data.

JSON (JavaScript Object Notation), yang didefinisikan oleh RFC 8259, adalah format pertukaran data yang paling banyak didukung. Sementara TOML mengutamakan keterbacaan manusia dengan sintaks minimal dan dukungan komentar, JSON mengutamakan interoperabilitas antar mesin. Konverter TOML ke JSON menjembatani kesenjangan ini dengan mengurai input TOML sesuai spesifikasi TOML v1.0.0 dan menghasilkan dokumen JSON yang setara secara struktural. Konversi mempertahankan semua data: string, integer, float, boolean, array, dan tabel dipetakan langsung ke padanannya dalam JSON.

TOML memiliki empat tipe tanggal/waktu native yang tidak dapat direpresentasikan langsung oleh JSON: offset date-time, local date-time, local date, dan local time. JSON tidak memiliki tipe tanggal, sehingga nilai-nilai ini diserialisasi sebagai string ISO 8601 selama konversi.

Mengapa Menggunakan Konverter TOML ke JSON?

File konfigurasi yang ditulis dalam TOML sering kali perlu dimasukkan ke dalam sistem yang hanya menerima JSON. Daripada menulis ulang file secara manual atau menginstal library parser secara lokal, konverter berbasis browser menangani transformasi dalam hitungan detik.

Kasus Penggunaan TOML ke JSON

Referensi Pemetaan Tipe TOML ke JSON

Setiap tipe TOML memiliki padanan JSON langsung, dengan satu pengecualian: nilai tanggal dan waktu. Tabel di bawah ini menunjukkan bagaimana setiap tipe TOML dikonversi ke JSON. Pemetaan ini mengikuti spesifikasi TOML v1.0.0 dan sesuai dengan perilaku parser standar seperti tomllib (Python), toml-rs (Rust), dan @iarna/toml (Node.js).

Integer TOML mendukung garis bawah untuk keterbacaan (misalnya 1_000_000) serta literal heksadesimal (0xDEADBEEF), oktal (0o755), dan biner (0b11010110). Semua ini dikonversi ke angka desimal biasa dalam JSON. TOML juga mendukung nilai float infinity dan NaN, tetapi tidak memiliki representasi JSON sehingga akan menyebabkan kesalahan konversi dalam mode ketat.

Contoh Kode

Contoh kerja konversi TOML ke JSON dalam empat bahasa. Masing-masing membaca file TOML, mengurainya, dan menghasilkan JSON terformat.

import { parse } from '@iarna/toml'
import fs from 'fs'

const toml = fs.readFileSync('config.toml', 'utf8')
const json = parse(toml)
console.log(JSON.stringify(json, null, 2))
// Input:  [server]
//         host = "localhost"
//         port = 8080
// Output: { "server": { "host": "localhost", "port": 8080 } }

import tomllib   # Python 3.11+ (standard library)
import json

with open('config.toml', 'rb') as f:
    data = tomllib.load(f)

print(json.dumps(data, indent=2, default=str))
# Dates become strings: "1979-05-27"
# Arrays of tables become JSON arrays of objects

package main

import (
    "encoding/json"
    "fmt"
    "os"

    "github.com/BurntSushi/toml"
)

func main() {
    var data map[string]any
    _, err := toml.DecodeFile("config.toml", &data)
    if err != nil {
        panic(err)
    }
    out, _ := json.MarshalIndent(data, "", "  ")
    fmt.Println(string(out))
}

# Using yj (YAML/JSON/TOML converter)
cat config.toml | yj -tj

# Using dasel
dasel -f config.toml -r toml -w json

# Using Python one-liner (3.11+)
python3 -c "import tomllib, json, sys; print(json.dumps(tomllib.load(sys.stdin.buffer), indent=2, default=str))" < config.toml

Pertanyaan yang Sering Diajukan