Loading…

Tentang Pemformat TOML Online

Konfigurasi `pyproject.toml`, `Cargo.toml`, atau `poetry` yang berantakan? Tempel TOML Anda atau jatuhkan file dan pemformat kami akan menormalkan spasi, merapikan array dan tabel sebaris, serta menjaga jarak bagian Anda tetap konsisten. Ideal untuk Python, Rust, Go, generator situs statis, dan proyek apa pun yang mengandalkan TOML untuk konfigurasi.

Fitur Utama Pemformat TOML

  • **Pemformat satu klik** untuk file dan cuplikan konfigurasi TOML
  • **Ukuran indentasi yang dapat dikonfigurasi** dari 1 hingga 8 spasi melalui slider *Ukuran Indentasi*
  • **Tombol gaya indentasi** – pilih antara spasi atau tab untuk indentasi
  • **Kontrol Bungkus / Panjang Baris** untuk menjaga array panjang dan tabel sebaris dalam lebar kolom yang dipilih
  • Mendukung file `.toml` seperti `pyproject.toml`, `Cargo.toml`, `Pipfile.toml`, `poetry.toml` dan lainnya
  • Parser TOML berbasis Prettier yang memahami tanggal, array, tabel bersarang dan tabel sebaris
  • Pemformatan stabil dan idempoten – menjalankannya kembali pada file yang sama tidak akan menyebabkan pergeseran format
  • Salin hasil yang diformat dengan satu klik, siap untuk editor atau komit Anda

🛠️ Cara Memformat File TOML Secara Online for toml-formatter

1

1. Tempel atau Unggah TOML Anda

📥 Tempel TOML ke editor atau seret-dan-lepas file `.toml` seperti `pyproject.toml` atau `Cargo.toml`. Alat ini mengurai konten sebagai TOML, bukan INI/JSON generik.

2

2. Pilih Pengaturan Indentasi & Bungkus

⚙️ Gunakan slider **Ukuran Indentasi** untuk memilih berapa banyak spasi per tingkat indentasi, dan alihkan **Gaya Indentasi** ke tab jika proyek Anda lebih memilihnya. Sesuaikan **Bungkus / Panjang Baris** untuk mengontrol kapan array panjang atau tabel sebaris harus membungkus (atau setel ke `0` untuk menonaktifkan pembungkusan).

3

3. Klik "Format"

🚀 Tekan tombol **Format**. Pemformat akan mengatur ulang array, membersihkan spasi di sekitar `=` dan koma, menormalkan spasi tabel, dan menegakkan jeda baris yang konsisten sambil mempertahankan data Anda.

4

4. Tinjau, Salin atau Simpan

🔍 Bandingkan TOML asli dan yang telah diformat. Setelah puas, salin hasilnya kembali ke editor atau simpan sebagai file `.toml` baru di proyek Anda.

Spesifikasi Teknis

Fitur TOML yang Didukung

Pemformat ini dibuat untuk konfigurasi proyek dunia nyata dan memahami konstruksi TOML modern.

FiturDukunganContoh / Catatan
Tabel & subtabel✅ Penuh[tool.poetry], [project], [database.replica]
Array✅ PenuhArray sebaris dan array tabel
Tabel sebaris✅ Lengkapserver = { alpha = "10.0.0.1", beta = "10.0.0.2" }
Tanggal & waktu✅ Lengkap2025-09-23T10:20:30Z dan format tanggal lokal
Komentar✅ Terjaga# komentar tetap dekat dengan pengaturan yang dijelaskannya
String multi-baris✅ LengkapString TOML bertanda kutip tiga untuk blok teks panjang

Opsi Pemformatan (Dipetakan ke Kontrol Alat)

Opsi ini diekspos langsung di UI dan dihubungkan ke plugin Prettier TOML yang mendasarinya:

OpsiKontrol UIRentang / NilaiBawaan
Ukuran indentasiSlider Ukuran Indentasi1–8 spasi2 spasi
Gaya indentasiPilih Gaya IndentasiSpasi / TabSpasi
Panjang barisBungkus / Panjang Baris0–120 kolom (0 = efektif tanpa bungkus)80 kolom
Akhir-barisAkhir baris (secara internal)LF / CRLFLF dalam output browser

Input & Batasan

Alat ini dioptimalkan untuk file TOML kecil hingga menengah yang umum ditemukan di repositori aplikasi.

ParameterNilai / PerilakuCatatan
Ekstensi file.tomlFile konfigurasi berbasis TOML apa pun
Tipe MIMEapplication/toml, text/x-tomlDigunakan untuk deteksi file di dropzone
Ukuran file maksimum~5 MBFile yang lebih besar mungkin lebih lambat dan lebih baik ditangani di CI
Karakter maksimum≈ 2.000.000Batas keras di runtime formatter untuk menghindari browser terkunci

Validasi & Penanganan Kesalahan

Jika file Anda bukan TOML yang valid (misalnya kehilangan `=` atau tanda kutip tidak cocok), formatter biasanya akan mengembalikan kesalahan yang dapat dibaca alih-alih output yang diformat. Perbaiki baris yang ditunjukkan dan jalankan formatter lagi.

Alternatif Baris Perintah untuk Pemformatan TOML

Suka hasilnya dan ingin gaya yang sama di CI atau pre-commit hooks? Berikut opsi yang ramah CLI:

Lintas platform (Node.js / Prettier)

Instal Prettier dan plugin TOML

npm install --save-dev prettier prettier-plugin-toml

Menambahkan Prettier dan parser TOML ke proyek Anda.

Format file TOML dengan Prettier

npx prettier --parser toml --write pyproject.toml

Menulis ulang `pyproject.toml` di tempat menggunakan aturan TOML Prettier.

Linux / macOS / Windows (Taplo CLI)

Format TOML menggunakan Taplo

taplo fmt pyproject.toml

Formatter CLI populer lainnya untuk file TOML.

Periksa pemformatan di CI

taplo fmt --check .

Gagalkan build jika file TOML tidak diformat dengan benar.

Gunakan alat online ini untuk edit cepat dan eksperimen, lalu terapkan gaya yang sama dengan Prettier atau Taplo di pipeline CI Anda.

Kasus Penggunaan Formatter TOML Umum

Pengemasan Python (`pyproject.toml`)

Jaga metadata proyek Python dan konfigurasi alat tetap bersih dan mudah ditinjau.

  • Sejajarkan bagian `[project]`, `[tool.poetry]` dan `[tool.black]`.
  • Normalisasi array dependensi dan penentu versi.
  • Buat perbedaan konfigurasi lebih mudah dibaca di pull request.
[project]
name = "my-app"
version = "0.1.0"

[tool.black]
line-length = 88
include = "\.(py|pyi)$"

Proyek Rust (`Cargo.toml`)

Rapikan manifes paket Rust di seluruh workspace dan microservices.

  • Jaga `[dependencies]` dan `[dev-dependencies]` tetap terurut dan spasi yang konsisten.
  • Normalisasikan tabel sebaris yang digunakan untuk bendera fitur kompleks.
  • Standarisasi pemformatan di beberapa krat dalam ruang kerja.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

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

Situs Statis & Alat (Hugo, Zola, dll.)

Bersihkan TOML yang digunakan untuk generator situs statis dan berbagai alat.

  • Format `config.toml` untuk Hugo atau generator situs statis lainnya.
  • Jaga blok konfigurasi multibahasa tetap mudah dibaca.
  • Normalisasikan daftar panjang seperti entri menu dan taksonomi.

❓ Frequently Asked Questions

❓Apa itu pemformat TOML?

Pemformat TOML secara otomatis menyusun ulang file TOML Anda agar mengikuti gaya yang konsisten: memperbaiki indentasi, menyelaraskan array dan tabel sebaris, menormalkan spasi di sekitar `=` dan koma, serta mempertahankan data sambil membuatnya lebih mudah dibaca dan ditinjau.

📏Bagaimana seharusnya saya memilih ukuran dan gaya indentasi?

Jika tim Anda tidak memiliki preferensi, **2 spasi** adalah default yang baik. Sesuaikan dengan gaya yang sudah digunakan di repositori Anda: jika file sebagian besar diindentasi dengan spasi, terus gunakan spasi; jika tab adalah standar tim, ubah **Gaya Indentasi** ke Tabs agar perubahan baru selaras dengan kode yang ada.

🧪Apakah pemformat memvalidasi sintaks TOML?

Parser dasar akan menolak TOML yang tidak valid (misalnya, `=` yang hilang atau tanda kutip yang tidak cocok). Dalam hal itu, alat menampilkan pesan kesalahan alih-alih keluaran yang diformat, sehingga Anda dapat memperbaiki masalah dan mencoba lagi.

🔁Apakah menjalankan pemformat dapat mengubah perilaku konfigurasi saya?

Pemformat dirancang untuk **mempertahankan semantik**: hanya mengubah spasi putih dan tata letak, bukan kunci, nilai, atau struktur tabel. Selama file asli adalah TOML yang valid, makna konfigurasi Anda harus tetap sama.

🔒Apakah aman memformat file konfigurasi sensitif?

Seperti alat daring lainnya, hindari menempelkan materi yang sangat sensitif seperti rahasia produksi. Untuk konfigurasi yang sangat rahasia, gunakan pemformat TOML lokal (seperti Prettier atau Taplo) di dalam lingkungan pengembangan pribadi Anda.

Pro Tips

Best Practice

Simpan `pyproject.toml` atau `Cargo.toml` yang diformat dengan rapi di cabang utama, lalu terapkan gaya yang sama di CI menggunakan Prettier atau Taplo.

Best Practice

Format TOML sebelum mengommit perubahan dependensi atau konfigurasi besar agar diff Git Anda fokus pada **perubahan aktual**, bukan gangguan spasi.

Best Practice

Saat merefaktor konfigurasi, format file terlebih dahulu, kommit, lalu ubah nilainya. Ini memudahkan meninjau apa yang benar-benar berubah.

Best Practice

Gunakan **ukuran indentasi** dan **panjang bungkus** yang sama di semua file TOML Anda untuk membuat navigasi lintas proyek dan tinjauan kode terasa konsisten.

Additional Resources

Spesifikasi TOML v1.0.0
Documentation
Plugin Prettier TOML
Documentation
Taplo – Perkakas TOML
Documentation

Other Tools