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

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

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

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

Temel Özellikler

Örnekler

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[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"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

Nasıl Kullanılır

1. 1

   TOML'unuzu Yapıştırın

   TOML'unuzu yukarıdaki giriş alanına girin veya yapıştırın. Gerçek bir Cargo.toml, pyproject.toml ya da dağıtım yapılandırmasını denemek için 'Örnek yükle'ye de tıklayabilirsiniz.

2. 2

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

   JSON, çıktı panelinde anında görünür. Hedef biçiminize uyması için Girinti seçeneğini (2 veya 4 boşluk) ayarlayın. Tarihler, tablolar ve tablo dizileri otomatik olarak işlenir.

3. 3

   Kopyalayın veya İndirin

   JSON'u panonuza almak için Kopyala'ya veya programınız, API'niz ya da araç geliştirmeniz için hazır bir .json dosyası olarak kaydetmek için İndir'e tıklayın.

Yaygın TOML Tuzakları

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

Yaygın Kullanım Senaryoları

Rust Cargo Meta Verisi

Bağımlılık panoları oluşturmak, crate sürümlerini ve özelliklerini denetlemek veya manifest verisini TOML yerine JSON bekleyen betiklere ve CI'ye beslemek için Cargo.toml'u JSON'a dönüştürün.

Python Proje Yapılandırması

PEP 621 proje meta verisini incelemek, bağımlılık listelerini çıkarmak veya paketleme yapılandırmasını programatik olarak okuyan araçları sürmek için pyproject.toml'u JSON'a dönüştürün.

Dağıtım Yapılandırması İncelemesi

Yönlendirmeleri, başlıkları ve derleme ayarlarını denetlemek veya farklı bir platform için eşdeğer yapılandırma üretmek amacıyla netlify.toml, foundry.toml ya da diğer platform yapılandırmalarını JSON'a dönüştürün.

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

JSON'u tercih eden bir sisteme geçerken TOML uygulama yapılandırmasını JSON'a dönüştürün veya jq gibi JSON araçlarıyla daha ileri dönüştürmeden önce bir ara adım olarak kullanın.

Statik Site Ayarları

Site ayarlarını taşımak, ortamlar arasında yapılandırmayı karşılaştırmak veya JSON destekli bir ayarlar arayüzü oluşturmak için Hugo config.toml'u JSON'a dönüştürün.

API ve Betik Girişi

İnsan tarafından yazılmış TOML'u, bir REST API'nin, sunucusuz işlevin veya otomasyon betiğinin doğrudan tüketebileceği JSON'a dönüştürerek okunabilir yapılandırma ile makine girişi arasında köprü kurun.

Teknik Ayrıntılar

smol-toml ile TOML 1.0.0 Ayrıştırma

TOML, sıfır bağımlılıklı, tam TOML 1.0.0 uyumlu bir ayrıştırıcı olan smol-toml kütüphanesiyle ayrıştırılır. İç içe tabloları, noktalı anahtarları, satır içi tabloları, tablo dizilerini, çok satırlı dizeleri ve dört tarih-saat türünün tümünü doğru şekilde işler ve ayrıştırma hatalarını satır ve sütun konumlarıyla bildirir.

Kayıpsız Tarih-Saat ve Güvenli Tam Sayı İşleme

TOML tarih-saatleri, tam türlerini (ofsetli tarih-saat, yerel tarih-saat, yerel tarih, yerel saat) koruyan JSON dizelerine seri hale getirilir. JavaScript'in güvenli aralığının (2^53 - 1) ötesindeki tam sayılar, ayrıştırma sırasında BigInt'e yükseltilir, ardından bir hassasiyet uyarısıyla en yakın JSON sayısına dönüştürülür, böylece geçerli TOML asla dönüştürülemeden kalmaz.

%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

Çok Büyük Tam Sayıları Dize Olarak Saklayın

TOML'unuzda 2^53 - 1'in ötesinde tam sayılar varsa (Snowflake kimlikleri, nanosaniye zaman damgaları, büyük sayaçlar), dönüştürmeden önce bunları dize olarak tırnak içine alın. Tarayıcıdaki JSON sayıları bunları tam olarak tutamaz ve araç yuvarlaması gerektiğinde sizi uyarır.

JSON Çıktısı İçin 2 Boşluk Girinti Tercih Edin

İki boşluk girinti, JSON için en yaygın kullanılan kuraldır ve çoğu biçimlendirici ve karşılaştırma aracıyla iyi çalışan temiz, okunabilir bir çıktı üretir. 4 boşluk girintiyi bir stil kılavuzu gerektirdiğinde saklayın.

Kullanmadan Önce JSON Çıktısını Doğrulayın

Dönüştürdükten sonra, JSON'u elle düzenlemeyi veya katı bir yere beslemeyi planlıyorsanız, geçerli ve tutarlı biçimlendirilmiş olduğunu doğrulamak için JSON Biçimlendirici aracımızdan geçirin.

TOML Yorumlarını Ayrı Tutun

JSON'da yorum söz dizimi olmadığından, TOML # yorumları dönüştürmede atılır. Yorumlar önemli belgelemeyse, orijinal TOML'u üretilen JSON'un yanında sürüm denetiminde tutun.

Tekrarlanan Bölümler İçin Tablo Dizileri Kullanın

Birden çok benzer bölümünüz olduğunda (sunucular, yönlendirmeler, ikili dosyalar), bunları [section] tekrar etmek yerine tablo dizileri ([[section]]) olarak yazın. Yinelenen tablo hatasına neden olmak yerine temiz bir JSON nesne dizisine dönüşürler.

Sıkça Sorulan Sorular