Konverter online gratis TOML ke INI

Format sumber: TOML

TOML adalah singkatan dari Tom’s Obvious, Minimal Language. TOML adalah format konfigurasi yang dapat dibaca manusia yang dirancang agar mudah ditulis dan mudah diparse. TOML banyak digunakan oleh pengembang untuk pengaturan aplikasi, metadata proyek, dan file konfigurasi build, terutama dalam ekosistem perangkat lunak modern seperti Rust, Python tooling, dan proyek lain yang berfokus pada pengembang.

TOML mendukung tabel bersarang, array, tanggal, boolean, angka, dan string. TOML dihargai karena kejelasannya dan karena mengurangi ambiguitas dibandingkan dengan format konfigurasi yang lebih lama.

Format target: INI

INI adalah format file konfigurasi sederhana yang menggunakan section, pasangan key-value, dan komentar. Format ini telah digunakan selama puluhan tahun di aplikasi Windows, perangkat lunak desktop, dan banyak alat lintas-platform. File INI mudah dibaca dan diedit secara manual, sehingga berguna untuk pengaturan aplikasi dasar dan kompatibilitas dengan sistem lama.

Kelebihan utama INI adalah kesederhanaannya dan dukungan yang luas. Namun, INI kurang ekspresif dibandingkan TOML: dukungan untuk tipe data terbatas, tidak ada struktur bersarang standar, dan penanganannya tidak konsisten di antara parser.

Cara melakukan konversi

Tidak ada konversi sempurna satu-ke-satu dari TOML ke INI karena TOML dapat merepresentasikan struktur data yang lebih kaya daripada INI. Pendekatan terbaik adalah meratakan (flatten) struktur TOML menjadi section INI dan pasangan key-value sederhana.

1. Periksa file TOML dan identifikasi tabel tingkat atas, tabel bersarang, array, serta nilai yang bukan string.
2. Tentukan strategi flattening. Umumnya, setiap tabel TOML menjadi section INI, dan tabel bersarang direpresentasikan dengan nama section bertitik atau gabungan.
3. Konversi nilai sederhana seperti string, integer, boolean, dan float menjadi pasangan key-value di INI.
4. Tangani array dengan hati-hati. INI tidak memiliki sintaks array yang universal, jadi array mungkin perlu digabung menjadi string yang dipisahkan koma atau menggunakan key yang diulang, tergantung pada aplikasi target.
5. Tinjau fitur TOML yang tidak didukung seperti inline tables, multiline strings, dates, dan struktur yang sangat bersarang, lalu sederhanakan agar kompatibel dengan INI.
6. Validasi hasilnya dengan membuka file INI di aplikasi target atau mengujinya menggunakan parser INI.

Jika Anda ingin konversi cepat berbasis browser, Anda dapat mengonversi file di 101convert.com secara gratis, tanpa menginstal perangkat lunak apa pun.

Untuk konversi manual, editor teks seperti Visual Studio Code, Notepad++, atau Sublime Text sering kali sudah cukup untuk file berukuran kecil. Untuk konversi yang lebih besar atau yang dapat diulang, pendekatan berbasis scripting lebih baik. Misalnya, Anda dapat menggunakan Python dengan TOML parser dan menulis logika kustom untuk menghasilkan sintaks INI.

Pemetaan contoh:

[database]
host = "localhost"
port = 5432

bisa menjadi:

[database]
host=localhost
port=5432

Kualitas, kompatibilitas, dan keterbatasan

Keterbatasan terbesar dalam konversi ini adalah bahwa INI tidak dapat sepenuhnya mempertahankan struktur TOML atau tipe data. Array TOML, tabel bersarang, dan nilai bertipe sering kali perlu disederhanakan, yang dapat menyebabkan hilangnya informasi. Jika file INI harus digunakan oleh aplikasi tertentu, ikuti konvensi INI yang diharapkan oleh aplikasi tersebut, karena penamaan section, key yang diulang, dan format nilai dapat berbeda.

Untuk hasil terbaik, pertahankan file TOML sebagai sumber otoritatif bila memungkinkan dan buat INI hanya untuk kompatibilitas dengan perangkat lunak yang memerlukannya. Jika konfigurasi kompleks, pertimbangkan apakah aplikasi target dapat menerima TOML secara langsung alih-alih mengonversinya.