Konverter JSON ke TOML

Apa Itu TOML dan Mengapa Mengonversi dari JSON?

// 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"

Fitur Utama

Contoh

{
  "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 }
  }
}

Cara Menggunakan

1. 1

   Tempel JSON Anda

   Masukkan atau tempel JSON Anda ke bidang input di atas. Anda juga dapat mengeklik 'Muat contoh' untuk mencoba sumber Cargo.toml, sumber pyproject.toml, atau objek pengaturan aplikasi.

2. 2

   Lihat Output TOML Langsung

   TOML muncul instan di panel output. Jika JSON Anda memiliki larik tingkat atas atau nilai null, alat menjelaskan persis apa yang harus dilakukan alih-alih menghasilkan output rusak.

3. 3

   Salin atau Unduh

   Klik Salin untuk mengambil TOML ke papan klip Anda, atau Unduh untuk menyimpannya sebagai berkas .toml yang siap untuk Cargo, Poetry, Hugo, Netlify, atau alat apa pun yang membaca TOML.

Jebakan JSON-ke-TOML Umum

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

Kasus Penggunaan Umum

Hasilkan Cargo.toml

Ubah JSON terstruktur — dari alat scaffolding, API, atau skrip — menjadi Cargo.toml Rust valid, dengan tabel [dependencies] bersarang dan tabel inline dihasilkan otomatis.

Hasilkan pyproject.toml

Konversi metadata proyek JSON menjadi pyproject.toml PEP 621, termasuk tabel [tool.*] bertitik, jadi perkakas yang memancarkan JSON dapat menghasilkan konfigurasi pemaketan Python.

Konfigurasi yang Dapat Disunting Manusia dari JSON

Transformasikan pengaturan JSON aplikasi menjadi berkas konfigurasi TOML yang mudah dibaca yang dapat disunting manusia dengan nyaman, dengan komentar ditambahkan setelahnya secara manual.

Pembuatan Konfigurasi Deployment

Hasilkan netlify.toml, foundry.toml, atau konfigurasi platform serupa dari JSON, mengubah objek bersarang dan larik objek menjadi tabel dan larik tabel yang diharapkan alat tersebut.

Migrasi Format Konfigurasi

Pindahkan konfigurasi dari sistem berbasis JSON ke berbasis TOML, menggunakan konverter ini sebagai jembatan dan peringatan null serta tingkat atas untuk menangkap apa pun yang tidak akan terpetakan.

Membuat Prototipe Struktur TOML

Sketsa konfigurasi sebagai JSON — format yang diketik lancar oleh sebagian besar pengembang — lalu konversi ke TOML untuk melihat tata letak tabel dan larik-tabel idiomatik sebelum menyerahkannya ke repo.

Detail Teknis

Penguraian JSON RFC 8259

Input JSON diuraikan dengan JSON.parse() asli browser, yang sepenuhnya sesuai RFC 8259. Sebelum serialisasi, alat memeriksa bahwa nilai tingkat atas adalah objek dan memindai nilai null sehingga dapat memperingatkan tentang kunci objek yang dihilangkan atau menolak null di dalam larik dengan jalur presisi.

Output TOML 1.0.0 via smol-toml

TOML dihasilkan dengan pustaka smol-toml, serializer tanpa-dependensi yang sepenuhnya sesuai TOML 1.0.0. Objek bersarang menjadi tabel, objek yang bersarang dalam menjadi tabel bertitik, dan larik objek menjadi larik tabel. Float dengan bagian pecahan nol ditulis sebagai bilangan bulat sesuai aturan TOML, dengan peringatan.

100% Berbasis Browser — Tanpa Unggah, Tanpa Server

Semua pemrosesan terjadi di mesin JavaScript browser Anda. Tidak ada data yang dikirim kapan pun. Input lebih besar dari 200KB beralih dari mode langsung ke manual (klik Konversi eksplisit) untuk menjaga antarmuka tetap responsif.

Praktik Terbaik

Bungkus Larik Tingkat Atas di Bawah Kunci

Jika data Anda secara alami adalah larik JSON, bungkus dalam objek dengan kunci deskriptif ({ "items": [...] }) sebelum mengonversi. Dokumen TOML harus berupa tabel di akar, dan kunci memberi larik Anda nama yang jelas di output.

Putuskan Apa Arti Null

Sebelum mengonversi, putuskan apakah bidang null harus hilang (menghapus kunci) atau membawa nilai. TOML akan menghilangkan null objek dan menolak null larik, jadi menyelesaikannya di JSON Anda dulu memberi output yang dapat diprediksi dan lengkap.

Gunakan Objek Bersarang untuk Pengelompokan

Kelompokkan pengaturan terkait ke objek bersarang di JSON Anda — mereka menjadi [tabel] dan tabel bertitik yang bersih di TOML, yang jauh lebih mudah dibaca daripada daftar kunci datar, sesuai dengan cara konfigurasi Cargo dan pyproject diorganisasi.

Validasi JSON Anda Dulu

Jika JSON Anda ditulis tangan atau berasal dari sumber yang tidak andal, validasi dengan Pemformat JSON kami untuk menangkap koma di akhir dan kesalahan kutip sebelum mengonversi ke TOML.

Tambahkan Komentar Setelah Mengonversi

JSON tidak memiliki komentar, jadi tidak ada yang terbawa. Karena TOML mendukung komentar #, tambahkan dokumentasi ke TOML yang dihasilkan secara manual — salah satu alasan utama untuk memindahkan konfigurasi yang disunting manusia ke TOML sejak awal.

Pertanyaan yang Sering Diajukan