TOML'dan JSON'a

Türler nasıl eşlenir

Çıktı her zaman 4 boşluklu girintiyle biçimlendirilir, dolayısıyla diziler ve nesneler birden çok satıra yayılır; yukarıdaki tablo okunabilirlik için değerleri tek satırda gösterir. Anahtar sırası TOML’unuzda göründüğü haliyle korunur.

Baştan sona örnek

title = "My App"

[server]
host = "localhost"
port = 8080

[[users]]
name = "alice"
admin = true

şuna dönüşür:

{
    "title": "My App",
    "server": {
        "host": "localhost",
        "port": 8080
    },
    "users": [
        {
            "name": "alice",
            "admin": true
        }
    ]
}

Desteklenen TOML ve gerçek sınırlar

Desteklenenler: noktalı bölüm adları dahil [tablo] başlıkları, [[tablo dizileri]], tek satırlık key = value çiftleri, \n, \t ve \" kaçışlarıyla basic dizeler "...", literal dizeler '...', sade ondalık tam ve kesirli sayılar, true/false, tek satırlık diziler (iç içe olabilir), satırın tamamını kaplayan # yorumları ve dize olarak geçirilen tarihler.

Desteklenmeyenler ve bunun yerine yapılacaklar:

• Çok satırlı dizeler (""" veya ''') ve çok satırlı diziler ayrıştırıcıyı hatayla durdurur. Önce değeri tek satıra alın.
• Satır içi tablolar açılmaz: point = { x = 1, y = 2 } nesne değil, "{ x = 1, y = 2 }" dizesi olarak çıkar. Bunu ayrı bir [point] bölümü olarak yeniden yazın. Cargo.toml’daki serde = { version = "1.0" } gibi bağımlılık satırları klasik örnektir.
• Eşittirin solundaki noktalı anahtarlar tek bir düz anahtar olarak kalır: server.host = "a" iç içe yapı kurmaz, "server.host" anahtarını üretir. Bunun yerine [server] başlığı kullanın. Başlıklardaki noktalı [bolum.adlari] ise doğru şekilde iç içe geçer.
• Değerden sonraki yorumlar ayıklanmaz: port = 8080 # main, "8080 # main" dizesine dönüşür. Yorumları kendi satırlarında tutun.
• Sade ondalık dışındaki sayı biçimleri tanınmaz: 1_000, 0xFF, 5e2, +99, inf ve nan tırnaklı dize olarak çıkar. Bunların yerine 1000, 255, 500, 99 yazın.
• Basic dizelerdeki \uXXXX kaçışları çözülmez. Bunun yerine gerçek karakteri yapıştırın.

Eksiksiz bir TOML 1.0 belgesi için toml2json gibi bir komut satırı dönüştürücüsü kullanın ya da dosyayı Python’un tomllib modülüyle yükleyip JSON’u oradan yazdırın.

Nerelerde işe yarar

• Hata ayıklarken bir TOML parçasını JSON olarak hızlıca incelemek.
• Yalnızca JSON kabul eden linter, betik veya envanter araçlarına basit yapılandırma değerleri aktarmak.
• Elle yazması daha rahat TOML notlarından test için JSON fikstürleri üretmek.
• Küçük ve düz yapılandırma dosyalarını taşımak; Hugo’nun birçok config.toml dosyası tam olarak böyledir.

Gidiş-dönüş notları

• Yorumlar asla hayatta kalmaz: JSON’da yorum sözdizimi hiç yoktur.
• Tarihler dize olarak kalır; sonraki kodun bunları yeniden tarih nesnelerine ayrıştırması gerekir.
• Büyük sayılar: JSON metninde tam sayılar 64 bit değer olarak korunur, ancak JavaScript tarafı 2^53 üzerinde hassasiyet kaybeder. Nanosaniye zaman damgalarına ve sayısal kimliklere dikkat edin.
• Anahtar sırası bu dönüştürücüde yazıldığı gibi korunur; başka JSON araçları belgeyi yeniden yazarken anahtarları sıralayabilir.

Ters yön

JSON → TOML daha zorlu yolculuktur, çünkü JSON’da TOML’un sahip olmadığı ya da farklı ele aldığı yapılar (derin anonim iç içelik, null) vardır. Gidiş-dönüş senaryolarının çoğu TOML tarafında elle düzeltme ister.