JSON to TOML Dönüştürücü

TOML Nedir ve Neden JSON'dan Dönüştürülür?

// Convert JSON to TOML in Node.js using the smol-toml library
import { stringify } from 'smol-toml';

const data = JSON.parse(`{
  "package": { "name": "my-app", "version": "1.0.0" },
  "dependencies": { "serde": { "version": "1.0" } }
}`);

// The top-level value must be an object; null values on objects are dropped.
const toml = stringify(data);

console.log(toml);
// [package]
// name = "my-app"
// version = "1.0.0"
//
// [dependencies.serde]
// version = "1.0"

Temel Özellikler

Örnekler

{
  "package": {
    "name": "my-app",
    "version": "1.0.0",
    "edition": "2021"
  },
  "dependencies": {
    "serde": { "version": "1.0", "features": ["derive"] },
    "tokio": { "version": "1", "features": ["full"] }
  }
}

{
  "build-system": {
    "requires": ["hatchling"],
    "build-backend": "hatchling.build"
  },
  "project": {
    "name": "my-package",
    "version": "0.3.1",
    "requires-python": ">=3.10",
    "dependencies": ["requests>=2.31", "pydantic>=2.0"]
  }
}

{
  "title": "My Service",
  "debug": false,
  "port": 8080,
  "database": {
    "host": "localhost",
    "port": 5432,
    "pool_size": 10
  },
  "features": ["auth", "metrics", "tracing"]
}

{
  "servers": [
    { "name": "alpha", "ip": "10.0.0.1", "ports": [8001, 8002] },
    { "name": "beta", "ip": "10.0.0.2", "ports": [9001] }
  ]
}

{
  "build": {
    "command": "npm run build",
    "publish": "dist",
    "environment": { "NODE_VERSION": "20" }
  },
  "redirects": [
    { "from": "/old", "to": "/new", "status": 301, "force": true }
  ]
}

{
  "tool": {
    "ruff": { "line-length": 100, "target-version": "py310" },
    "black": { "line-length": 100 }
  }
}

Nasıl Kullanılır

1. 1

   JSON'unuzu Yapıştırın

   JSON'unuzu yukarıdaki giriş alanına girin veya yapıştırın. Bir Cargo.toml kaynağı, pyproject.toml kaynağı ya da uygulama ayarları nesnesi denemek için 'Örnek yükle'ye de tıklayabilirsiniz.

2. 2

   Canlı TOML Çıktısını Görün

   TOML, çıktı panelinde anında görünür. JSON'unuzda üst düzey bir dizi veya null değerler varsa, araç bozuk çıktı üretmek yerine tam olarak ne yapmanız gerektiğini açıklar.

3. 3

   Kopyalayın veya İndirin

   TOML'u panonuza almak için Kopyala'ya veya Cargo, Poetry, Hugo, Netlify ya da TOML okuyan herhangi bir araç için hazır bir .toml dosyası olarak kaydetmek için İndir'e tıklayın.

Yaygın JSON-TOML Tuzakları

[1, 2, 3]

{ "items": [1, 2, 3] }

{ "name": "a", "nickname": null }

{ "name": "a", "nickname": "" }

{ "ports": [8001, null, 8003] }

{ "ports": [8001, 8003] }

{ 'name': 'a', 'active': true, }

{ "name": "a", "active": true }

{ "ratio": 1.0 }  →  ratio = 1

{ "ratio": 1.5 }  →  ratio = 1.5

{ "server": { "a": 1 }, "server": [1] }

{ "server": { "a": 1 }, "servers": [1] }

Yaygın Kullanım Senaryoları

Cargo.toml Üret

Yapılandırılmış JSON'u — bir iskele aracından, bir API'den veya bir betikten — iç içe [dependencies] tabloları ve otomatik olarak üretilen satır içi tablolarla geçerli bir Rust Cargo.toml'a dönüştürün.

pyproject.toml Üret

JSON proje meta verisini, noktalı [tool.*] tabloları dahil olmak üzere bir PEP 621 pyproject.toml'a dönüştürün, böylece JSON yayan araçlar Python paketleme yapılandırması üretebilir.

JSON'dan İnsan Tarafından Düzenlenebilir Yapılandırma

Bir uygulamanın JSON ayarlarını, insanların rahatça düzenleyebileceği okunabilir bir TOML yapılandırma dosyasına dönüştürün ve daha sonra elle yorumlar ekleyin.

Dağıtım Yapılandırması Üretimi

JSON'dan netlify.toml, foundry.toml veya benzeri platform yapılandırmaları üretin; iç içe nesneleri ve nesne dizilerini bu araçların beklediği tablolara ve tablo dizilerine dönüştürün.

Yapılandırma Biçimi Geçişi

Yapılandırmayı JSON tabanlı bir sistemden TOML tabanlı bir sisteme taşıyın; bu dönüştürücüyü köprü olarak ve eşlenmeyecek her şeyi yakalamak için null ve üst düzey uyarılarını kullanın.

TOML Yapısı Prototipleme

Bir yapılandırmayı JSON olarak taslaklaştırın — çoğu geliştiricinin akıcı biçimde yazdığı bir biçim — sonra bir depoya işlemeden önce doğal tablo ve tablo dizisi düzenini görmek için TOML'a dönüştürün.

Teknik Ayrıntılar

RFC 8259 JSON Ayrıştırma

JSON girişi, tam RFC 8259 uyumlu olan tarayıcının yerel JSON.parse() işleviyle ayrıştırılır. Seri hale getirmeden önce araç, üst düzey değerin bir nesne olduğunu doğrular ve bırakılan nesne anahtarları hakkında uyarabilmesi ya da bir dizinin içindeki bir null'u kesin bir yolla reddedebilmesi için null değerleri tarar.

smol-toml ile TOML 1.0.0 Çıktısı

TOML, sıfır bağımlılıklı, tam TOML 1.0.0 uyumlu bir seri hale getirici olan smol-toml kütüphanesiyle üretilir. İç içe nesneler tablolar olur, derin iç içe nesneler noktalı tablolar olur ve nesne dizileri tablo dizileri olur. Kesirli kısmı sıfır olan kayan sayılar, TOML kurallarına göre bir uyarıyla tam sayı olarak yazılır.

%100 Tarayıcı Tabanlı — Yükleme Yok, Sunucu Yok

Tüm işlemler tarayıcınızın JavaScript motorunda gerçekleşir. Hiçbir noktada veri iletilmez. 200KB'ın üzerindeki girişler, arayüzü yanıt verir tutmak için canlıdan manuel moda (açık bir Dönüştür tıklaması) geçer.

En İyi Uygulamalar

Üst Düzey Dizileri Bir Anahtar Altına Sarın

Verileriniz doğal olarak bir JSON dizisiyse, dönüştürmeden önce bunu açıklayıcı bir anahtara sahip bir nesneye ({ "items": [...] }) sarın. TOML belgeleri kökte bir tablo olmalıdır ve anahtar, dizinize çıktıda net bir ad verir.

Null'ların Ne Anlama Gelmesi Gerektiğine Karar Verin

Dönüştürmeden önce, bir null alanın kaybolması (anahtarı bırakmak) mı yoksa bir değer taşıması mı gerektiğine karar verin. TOML nesne null'larını bırakır ve dizi null'larını reddeder, bu nedenle bunları önce JSON'unuzda çözmek öngörülebilir, eksiksiz çıktı verir.

Gruplama İçin İç İçe Nesneler Kullanın

İlgili ayarları JSON'unuzda iç içe nesnelerde gruplayın — bunlar TOML'da temiz [tablolar] ve noktalı tablolar olur; bu, düz bir anahtar listesinden çok daha okunabilirdir ve Cargo ile pyproject yapılandırmalarının düzenlendiği biçimle örtüşür.

Önce JSON'unuzu Doğrulayın

JSON'unuz elle yazılmışsa veya güvenilmez bir kaynaktan geliyorsa, TOML'a dönüştürmeden önce sondaki virgülleri ve tırnak hatalarını yakalamak için JSON Biçimlendirici aracımızla doğrulayın.

Dönüştürdükten Sonra Yorumlar Ekleyin

JSON'da yorum yoktur, bu nedenle hiçbiri aktarılmaz. TOML # yorumlarını desteklediğinden, üretilen TOML'a elle belgeleme ekleyin — insan tarafından düzenlenen yapılandırmayı TOML'a taşımanın ana nedenlerinden biri budur.

Sıkça Sorulan Sorular