TOML'den JSON'a

TOML'den JSON'a Dönüşüm Nedir?

TOML (Tom's Obvious Minimal Language), insanlar için tasarlanmış bir yapılandırma dosyası formatıdır. Hash tablosuna belirsizlik olmadan eşlenir; iç içe tabloları, tipli değerleri ve satır içi yorumları destekler. Pek çok araç ve çerçeve, TOML'u birincil yapılandırma formatı olarak kullanır: Rust projeleri Cargo.toml'a güvenir, Python paketleme pyproject.toml'ı kullanır, Hugo statik siteleri config.toml aracılığıyla yapılandırılır. TOML'u çevrimiçi JSON'a dönüştürmek, bu yapılandırma dosyalarını hemen hemen her programlama dilinin, API'nin ve veri hattının yerel olarak tüketebileceği bir formata dönüştürmenizi sağlar.

RFC 8259 ile tanımlanan JSON (JavaScript Object Notation), en yaygın desteklenen veri alışverişi formatıdır. TOML minimal sözdizimi ve yorum desteğiyle insan okunabilirliğini önceliklendirirken, JSON makine birlikte çalışabilirliğini önceliklendirmektedir. TOML'den JSON'a dönüştürücü, TOML girişini TOML v1.0.0 spesifikasyonuna göre ayrıştırarak yapısal olarak eşdeğer bir JSON belgesi üretmek suretiyle bu boşluğu kapatır. Dönüşüm tüm verileri korur: dizgeler, tamsayılar, ondalık sayılar, boolean'lar, diziler ve tablolar doğrudan JSON karşılıklarına eşlenir.

TOML'un JSON'ın doğrudan temsil edemediği dört yerel tarih/saat türü vardır: offset datetime, yerel datetime, yerel tarih ve yerel saat. JSON'un tarih türü olmadığından bu değerler dönüşüm sırasında ISO 8601 dizgeleri olarak serileştirilir.

Neden TOML'den JSON'a Dönüştürücü Kullanmalısınız?

TOML ile yazılmış yapılandırma dosyalarının genellikle yalnızca JSON kabul eden sistemlere beslenmesi gerekir. Dosyayı elle yeniden yazmak veya yerel olarak bir ayrıştırıcı kütüphanesi kurmak yerine, tarayıcı tabanlı bir dönüştürücü dönüşümü saniyeler içinde gerçekleştirir.

TOML'den JSON'a Kullanım Senaryoları

TOML'den JSON'a Tip Eşleme Referansı

Her TOML tipinin doğrudan bir JSON karşılığı vardır; tek istisna tarih ve saat değerleridir. Aşağıdaki tablo, her TOML tipinin JSON'a nasıl dönüştüğünü göstermektedir. Bu eşleme TOML v1.0.0 spesifikasyonunu izler ve tomllib (Python), toml-rs (Rust) ve @iarna/toml (Node.js) gibi standart ayrıştırıcıların davranışıyla örtüşür.

TOML tamsayıları okunabilirlik için alt çizgi (ör. 1_000_000) ve onaltılık (0xDEADBEEF), sekizlik (0o755) ile ikili (0b11010110) sabitlerini destekler. Tüm bunlar JSON'da düz onluk sayılara dönüştürülür. TOML ayrıca sonsuz ve NaN ondalık değerlerini destekler; ancak bunların JSON karşılığı yoktur ve katı modda dönüşüm hatasına neden olur.

Kod Örnekleri

Dört dilde TOML'den JSON'a dönüşümün çalışan örnekleri. Her biri bir TOML dosyasını okur, ayrıştırır ve biçimlendirilmiş JSON çıktısı verir.

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

Sıkça Sorulan Sorular