JSON'dan TOML'a Dönüştürücü

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

JSON'dan TOML'a dönüşüm, verileri JavaScript Object Notation'dan Tom's Obvious Minimal Language'e aktarır. JSON, yapılandırılmış verileri temsil etmek için süslü parantez, köşeli parantez ve tırnaklı anahtarlar kullanır. TOML ise INI dosyası gibi okunan ancak katı tiplemeye sahip bölüm başlıkları (tablolar olarak adlandırılır) içeren düz anahtar-değer sözdizimini kullanır. TOML, makine değişimi yerine insan okunabilirliğinin ön planda olduğu yapılandırma dosyaları için özel olarak tasarlanmıştır.

TOML; Rust (Cargo.toml), Python paketleme (pyproject.toml), Hugo statik siteler, Netlify dağıtım ayarları ve pek çok CLI aracı için varsayılan yapılandırma formatı haline gelmiştir. Kaynak veriniz bir API yanıtından, dışa aktarılmış bir yapılandırmadan ya da oluşturulmuş bir dosyadan JSON olarak geldiğinde ve hedef sisteminiz TOML beklediğinde, JSON nesnelerini TOML tablolarına, JSON dizilerini TOML dizilerine eşleyen ve her veri tipini doğru şekilde koruyan bir dönüştürücüye ihtiyaç duyarsınız.

JSON'dan TOML'a çevrimiçi dönüştürme, mevcut JSON verilerinden geçerli TOML üretmenin en hızlı yoludur. Dönüşüm, tür eşlemesini otomatik olarak gerçekleştirir: JSON dizgeleri TOML dizgelerine, JSON sayıları TOML tamsayı veya ondalık sayılarına, JSON boolean'ları doğrudan eşlenir, JSON nesneleri ise TOML tablolarına dönüşür. Tek istisna null'dür — TOML'un null türü yoktur, bu nedenle null değerleri dönüştürücüye bağlı olarak ya atlanır ya da boş dizgeye çevrilir.

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

TOML yapılandırma dosyalarının beklediği formattır; JSON ise API'lerin ve araçların ürettiği formattır. Bu dönüştürücü, verileri manuel olarak yeniden yazmadan iki format arasında geçiş yapmanızı sağlar.

JSON'dan TOML'a Kullanım Senaryoları

JSON ve TOML Karşılaştırması

JSON ve TOML yetenekler açısından örtüşür; ancak sözdizimi, tür desteği ve amaçlanan kullanım bakımından farklılaşır. Bu tablo, dönüşümü etkileyen farkları gösterir.

TOML Dönüşümündeki Tuzaklar

TOML'un, JSON'dan farklı olan ve dönüşüm çıktısını etkileyen kuralları vardır. Bu dört sorun en fazla karışıklığa neden olur.

Kod Örnekleri

JSON'u TOML'a programatik olarak dönüştürmek, çoğu dilde bir TOML serileştirme kütüphanesi gerektirir. Standart kütüphaneler JSON'u ayrıştırır; TOML çıktısı için özel bir paket gerekir.

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

Sıkça Sorulan Sorular