Loading…

Hakkında Çevrimiçi TOML Biçimlendirici

Dağınık `pyproject.toml`, `Cargo.toml` veya `poetry` yapılandırmaları mı? TOML'nizi yapıştırın veya bir dosya bırakın ve biçimlendiricimiz boşlukları normalleştirecek, dizileri ve satır içi tabloları düzenleyecek, bölümlerinizin tutarlı aralıklı kalmasını sağlayacaktır. Python, Rust, Go, statik site oluşturucuları ve yapılandırma için TOML kullanan herhangi bir proje için idealdir.

TOML Biçimlendiricinin Temel Özellikleri

  • TOML yapılandırma dosyaları ve parçacıkları için **tek tıklamalı güzelleştirici**
  • *Girinti Boyutu* kaydırıcısı ile 1'den 8 boşluğa kadar **yapılandırılabilir girinti boyutu**
  • **Girinti stili değiştirme** – girinti için boşluklar veya sekmeler arasında seçim yapın
  • Uzun dizileri ve satır içi tabloları seçilen sütun genişliğinde tutmak için **Kaydırma / Satır Uzunluğu** kontrolü
  • `pyproject.toml`, `Cargo.toml`, `Pipfile.toml`, `poetry.toml` ve daha fazlası gibi `.toml` dosyalarını destekler
  • Tarihleri, dizileri, iç içe tabloları ve satır içi tabloları anlayan Prettier tabanlı TOML ayrıştırıcı
  • Kararlı, idempotent biçimlendirme – aynı dosyada yeniden çalıştırmak biçimlendirme kaymasına neden olmaz
  • Biçimlendirilmiş çıktının tek tıklamayla kopyalanması, düzenleyiciniz veya commit'iniz için hazır

🛠️ TOML Dosyalarını Çevrimiçi Nasıl Biçimlendirilir for toml-formatter

1

1. TOML'unuzu Yapıştırın veya Yükleyin

📥 TOML'u düzenleyiciye yapıştırın veya `pyproject.toml` veya `Cargo.toml` gibi bir `.toml` dosyasını sürükleyip bırakın. Araç içeriği TOML olarak ayrıştırır, genel INI/JSON olarak değil.

2

2. Girinti ve Kaydırma Ayarlarını Seçin

⚙️ Girinti başına kaç boşluk olacağını seçmek için **Girinti Boyutu** kaydırıcısını kullanın ve projeniz bunları tercih ediyorsa **Girinti Stili**ni sekmelere geçirin. Uzun dizilerin veya satır içi tabloların ne zaman kaydırılacağını kontrol etmek için **Kaydırma / Satır Uzunluğu**nu ayarlayın (veya kaydırmayı etkin bir şekilde devre dışı bırakmak için `0` olarak ayarlayın).

3

3. "Biçimlendir"e Tıklayın

🚀 **Biçimlendir** düğmesine basın. Biçimlendirici dizileri yeniden düzenleyecek, `=` ve virgüller etrafındaki boşlukları temizleyecek, tablo boşluklarını normalleştirecek ve verilerinizi korurken tutarlı satır sonları uygulayacaktır.

4

4. İnceleyin, Kopyalayın veya Kaydedin

🔍 Orijinal ve biçimlendirilmiş TOML'u karşılaştırın. Memnun kaldığınızda, sonucu düzenleyicinize geri kopyalayın veya projenizde yeni bir `.toml` dosyası olarak kaydedin.

Teknik Özellikler

Desteklenen TOML Özellikleri

Biçimlendirici, gerçek dünya proje yapılandırmaları için oluşturulmuştur ve modern TOML yapılarını anlar.

ÖzellikDestekÖrnekler / Notlar
Tablolar ve alt tablolar✅ Tam[tool.poetry], [project], [database.replica]
Diziler✅ TamSatır içi diziler ve tablo dizileri
Satır içi tablolar✅ Tamsunucular = { alfa = "10.0.0.1", beta = "10.0.0.2" }
Tarihler ve saatler✅ Tam2025-09-23T10:20:30Z ve yerel tarih biçimleri
Yorumlar✅ Korundu# yorumlar açıkladıkları ayarların yakınında kalır
Çok satırlı dizeler✅ TamUzun metin blokları için üç tırnaklı TOML dizeleri

Biçimlendirme Seçenekleri (Araç Kontrollerine Eşlenmiş)

Bu seçenekler doğrudan kullanıcı arayüzünde sunulur ve altta yatan Prettier TOML eklentisine bağlanır:

SeçenekUI KontrolüAralık / DeğerlerVarsayılan
Girinti boyutuGirinti Boyutu kaydırıcısı1–8 boşluk2 boşluk
Girinti stiliGirinti Stili seçimiBoşluklar / SekmelerBoşluklar
Satır uzunluğuKaydır / Satır Uzunluğu0–120 sütun (0 = etkin kaydırma yok)80 sütun
Satır sonuSatır sonu (dahili)LF / CRLFTarayıcı çıktısında LF

Girdi ve Sınırlar

Araç, uygulama depolarında yaygın olarak bulunan küçük ve orta ölçekli TOML dosyaları için optimize edilmiştir.

ParametreDeğer / DavranışNotlar
Dosya uzantıları.tomlHerhangi bir TOML tabanlı yapılandırma dosyası
MIME türleriapplication/toml, text/x-tomlSürükle-bırak alanında dosya tespiti için kullanılır
Maksimum dosya boyutu~5 MBDaha büyük dosyalar daha yavaş olabilir ve CI'da işlenmesi daha iyidir
Maksimum karakter≈ 2.000.000Tarayıcı kilitlenmelerini önlemek için biçimlendirici çalışma zamanında sabit sınır

Doğrulama & Hata Yönetimi

Dosyanız geçerli TOML değilse (örneğin `=` eksik veya tırnak uyuşmazlığı), biçimlendirici genellikle biçimlendirilmiş çıktı yerine okunabilir bir hata döndürür. Belirtilen satırı düzeltin ve biçimlendiriciyi tekrar çalıştırın.

TOML Biçimlendirme için Komut Satırı Alternatifleri

Sonuçtan memnun musunuz ve CI veya pre-commit hook'larında aynı stili mi istiyorsunuz? İşte CLI dostu seçenekler:

Çapraz platform (Node.js / Prettier)

Prettier ve TOML eklentisini yükleyin

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

Projenize Prettier ve TOML ayrıştırıcısını ekler.

Prettier ile bir TOML dosyasını biçimlendirin

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

Prettier'ın TOML kurallarını kullanarak `pyproject.toml` dosyasını yerinde yeniden yazar.

Linux / macOS / Windows (Taplo CLI)

Taplo kullanarak TOML'yi biçimlendirin

taplo fmt pyproject.toml

TOML dosyaları için başka bir popüler CLI biçimlendiricisi.

CI'da biçimlendirmeyi kontrol edin

taplo fmt --check .

TOML dosyaları düzgün biçimlendirilmemişse derlemeyi başarısız yapar.

Hızlı düzenlemeler ve denemeler için bu çevrimiçi aracı kullanın, ardından aynı stili CI pipeline'larınızda Prettier veya Taplo ile zorunlu kılın.

Yaygın TOML Biçimlendirici Kullanım Senaryoları

Python Paketleme (`pyproject.toml`)

Python proje meta verilerini ve araç yapılandırmasını temiz ve incelemesi kolay tutun.

  • `[project]`, `[tool.poetry]` ve `[tool.black]` bölümlerini hizalayın.
  • Bağımlılık dizilerini ve sürüm belirteçlerini normalleştirin.
  • Pull request'lerdeki yapılandırma farklarını okumayı kolaylaştırın.
[project]
name = "my-app"
version = "0.1.0"

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

Rust Projeleri (`Cargo.toml`)

Çalışma alanları ve mikroservisler arasında Rust paket bildirimlerini düzenli tutun.

  • `[dependencies]` ve `[dev-dependencies]` bölümlerini sıralı ve tutarlı aralıklı tutun.
  • Karmaşık özellik bayrakları için kullanılan satır içi tabloları normalleştirin.
  • Bir çalışma alanındaki birden fazla kütüphane arasında biçimlendirmeyi standartlaştırın.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

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

Statik Siteler & Araçlar (Hugo, Zola, vb.)

Statik site oluşturucuları ve çeşitli araçlar için kullanılan TOML'yi temizleyin.

  • Hugo veya diğer statik site oluşturucular için `config.toml` dosyasını biçimlendirin.
  • Çok dilli yapılandırma bloklarını okunabilir tutun.
  • Menü girişleri ve sınıflandırmalar gibi uzun listeleri normalleştirin.

❓ Frequently Asked Questions

❓TOML biçimlendirici nedir?

Bir TOML biçimlendirici, TOML dosyalarınızı tutarlı bir stil izleyecek şekilde otomatik olarak yeniden yapılandırır: girintiyi düzeltir, dizileri ve satır içi tabloları hizalar, `=` ve virgüller etrafındaki boşlukları normalleştirir ve veriyi korurken okumayı ve incelemeyi kolaylaştırır.

📏Girinti boyutunu ve stilini nasıl seçmeliyim?

Ekibinizin bir tercihi yoksa, **2 boşluk** iyi bir varsayılandır. Deponuzda zaten kullanılan stille eşleştirin: dosyalar çoğunlukla boşluklarla girintilenmişse boşluk kullanmaya devam edin; sekmeler takım standardıysa, **Girinti Stili**'ni Sekmelere değiştirerek yeni değişikliklerin mevcut kodla hizalanmasını sağlayın.

🧪Biçimlendirici TOML sözdizimini doğrular mı?

Altta yatan ayrıştırıcı geçersiz TOML'yi (örneğin, eksik `=` veya uyumsuz tırnak işaretleri) reddeder. Bu durumda, araç biçimlendirilmiş çıktı yerine bir hata mesajı gösterir, böylece sorunu düzeltip tekrar deneyebilirsiniz.

🔁Biçimlendiriciyi çalıştırmak yapılandırma davranışımı değiştirebilir mi?

Biçimlendirici **anlamı koruyacak** şekilde tasarlanmıştır: yalnızca boşluk ve düzeni değiştirir, anahtarları, değerleri veya tablo yapısını değil. Orijinal dosya geçerli bir TOML olduğu sürece, yapılandırmanızın anlamı aynı kalmalıdır.

🔒Hassas yapılandırma dosyalarını biçimlendirmek güvenli mi?

Herhangi bir çevrimiçi araçta olduğu gibi, üretim sırları gibi son derece hassas materyalleri yapıştırmaktan kaçının. Yüksek gizlilikteki yapılandırmalar için, özel geliştirme ortamınızın içinde yerel bir TOML biçimlendirici (Prettier veya Taplo gibi) kullanın.

Pro Tips

Best Practice

Ana dalınızda güzelce biçimlendirilmiş bir `pyproject.toml` veya `Cargo.toml` tutun, ardından CI'da Prettier veya Taplo kullanarak aynı stili zorunlu kılın.

Best Practice

Büyük bağımlılık veya yapılandırma değişikliklerini işlemeden önce TOML'yi biçimlendirin, böylece Git farklarınız **gerçek değişikliklere** odaklansın, boşluk gürültüsüne değil.

Best Practice

Yapılandırmaları yeniden düzenlerken, önce dosyayı biçimlendirin, işleyin, sonra değerleri değiştirin. Bu, gerçekte neyin değiştiğini incelemeyi kolaylaştırır.

Best Practice

Tüm TOML dosyalarınızda aynı **girinti boyutu** ve **satır sarma uzunluğu** kullanarak projeler arası gezinme ve kod incelemelerinde tutarlılık hissi yaratın.

Additional Resources

TOML v1.0.0 Belirtimi
Documentation
Prettier TOML Eklentisi
Documentation
Taplo – TOML Araç Seti
Documentation

Other Tools