Swift Biçimlendiricinin Temel Özellikleri
- Swift kodunda girinti, boşluk ve parantezlerin **tek tıkla temizlenmesi**
- *Girinti Boyutu* kaydırıcısı ile **yapılandırılabilir girinti boyutu** (1–8 boşluk)
- Uzun ifadeleri tercih ettiğiniz sütun genişliğinde tutmak için **Sarma / Satır Uzunluğu** kontrolü
- Standart `.swift` kaynak dosyalarını ve yapıştırılan parçaları destekler
- **iOS, macOS, watchOS, tvOS ve sunucu tarafı Swift** projeleri için harika
- Perde arkasında SwiftFormat tarzı bir motor kullanarak deyimsel Swift çıktısı üretir
- İdempotent biçimlendirme – birden fazla çalıştırıldığında aynı çıktıyı verir
- Hesap gerekmez – sadece yapıştırın, biçimlendirin ve temizlenmiş sonucu kopyalayın
🛠️ Swift Biçimlendirici Nasıl Kullanılır for swift-formatter
1. Swift Kodunuzu Yapıştırın veya Yükleyin
📥 Swift kodunu doğrudan düzenleyiciye yapıştırın veya bir `.swift` dosyasını sürükleyip bırakın. Araç, tipik Xcode tarzı Swift kaynakları için optimize edilmiştir.
2. Girinti & Satır Uzunluğunu Ayarlayın
📏 Her girinti seviyesinin kaç boşluk kullanacağını seçmek için **Girinti Boyutu** kaydırıcısını kullanın ve uzun satırların nerede kaydırılacağını kontrol etmek için **Kaydırma / Satır Uzunluğu**'nu yapılandırın (veya kaydırma tabanlı biçimlendirmeyi devre dışı bırakmak için `0` olarak ayarlayın).
3. “Biçimlendir”e Tıklayın
⚡ SwiftFormat tarzı kuralları uygulamak için **Biçimlendir** düğmesine basın. Biçimlendirici, girintiyi normalleştirir, `:` ve operatörler etrafındaki boşlukları düzenler ve uzun satırları ayarlarınıza göre kaydırır.
4. Sonucu İnceleyin ve Kopyalayın
🔍 Orijinal ve biçimlendirilmiş sürümleri karşılaştırın. Sonuçtan memnun kaldığınızda, biçimlendirilmiş Swift kodunu Xcode'a, bir Swift Playground'a veya Git commit'inize geri kopyalayın.
Teknik Özellikler
Biçimlendirme Motoru & Stili
Araç, kod tabanınızın dosyalar ve katkıda bulunanlar arasında tutarlı kalmasını sağlamak için yaygın SwiftFormat kurallarını yansıtır.
| Yön | Davranış | Notlar |
|---|---|---|
| Dil | Swift | Swift 5+ kaynak dosyalarıyla en iyi şekilde çalışır. |
| Girinti | Seviye başına yapılandırılabilir boşluklar | **Girinti Boyutu** seçeneği ile kontrol edilir (1–8). |
| Satır Kaydırma | İsteğe bağlı kaydırma sütunu | **Kaydırma / Satır Uzunluğu** ile kontrol edilir (0–120; `0` = kaydırma yok). |
| Boşluk | `:` ve operatörler etrafında normalleştirilmiş | Okunabilirliği ve kod incelemeleri arasında tutarlılığı artırır. |
| İdempotent Çıktı | Aynı girdi → aynı çıktı | Biçimlendirme kayması olmadan birden fazla çalıştırmak güvenlidir. |
Desteklenen Girdi & Sınırlar
Apple platformu ve sunucu tarafı Swift projelerinde kullanılan gerçek dünya Swift kaynak dosyalarına odaklanır.
| Parametre | Değer / Davranış | Notlar |
|---|---|---|
| Dosya uzantıları | .swift | Standart Swift kaynak dosyaları. |
| MIME türleri | text/x-swift | Editör ve bırakma alanı tespiti için dahili olarak kullanılır. |
| Maksimum giriş boyutu | ≈ 2 MB kaynak | Çok büyük dosyalar CI'da yerel SwiftFormat ile biçimlendirilmelidir. |
| Çıktı uzantısı | .swift | Biçimlendirilmiş içerik en iyi Swift kaynak dosyası olarak kaydedilir. |
Doğrulama & Hatalar
Biçimlendirici sözdizimsel olarak geçerli Swift bekler. Girdi eksik veya büyük sözdizimi hataları içeriyorsa, biçimlendirilmiş çıktı yerine hata verebilir veya hata mesajı döndürebilir.
Komut Satırı Alternatifleri ile SwiftFormat
Xcode, CI veya öncesi commit hook'larında aynı stili mi istiyorsunuz? SwiftFormat'ı doğrudan kullanın:
macOS (Homebrew)
Homebrew ile SwiftFormat'ı yükleyin
brew install swiftformatSisteminize `swiftformat` CLI'sını ekler.
Tek bir Swift dosyasını biçimlendir
swiftformat MyViewController.swiftDosyayı varsayılan SwiftFormat kurallarıyla yerinde yeniden yazar.
Tüm bir Xcode projesini biçimlendir
swiftformat .Mevcut dizindeki tüm `.swift` dosyalarını özyinelemeli olarak biçimlendirir.
Proje Seviyesi Yapılandırma
Özel bir yapılandırma kullan
swiftformat . --config .swiftformat`.swiftformat` yapılandırma dosyasında saklanan takıma özel kuralları uygular.
Git öncesi commit ile entegre et
swiftformat . && git commitAna dalınızı temiz tutmak için her commit öncesinde SwiftFormat'ı çalıştırın.
Swift Biçimlendirici için Pratik Kullanım Senaryoları
iOS & macOS Uygulama Geliştirme
UIKit, SwiftUI ve Combine ağırlıklı kodları okunabilir ve tutarlı tutun, özellik dalları arasında.
- Kod incelemesinden önce view controller'ların, view model'ların ve servislerin biçimlendirmesini standartlaştırın.
- Karalama defteri veya prototip Swift kodunu üretim hedeflerine kopyalamadan önce temizleyin.
- Karmaşık SwiftUI view hiyerarşilerinin girintilerini ve sarmalamasını hizalayın.
struct ContentView: View {
var body: some View {
VStack {
Text("Hello")
Button("Tap me") {
print("Tapped")
}
}
}
}
Sunucu Taraflı Swift (Vapor, Hummingbird, vb.)
API işleyicilerini ve yönlendirme kodunu taramayı ve incelemeyi kolaylaştırın.
- Karmaşık zincirlerin takip edilmesini kolaylaştırmak için route'ları ve middleware bildirimlerini yeniden biçimlendirin.
- Uzun özellik listelerine sahip JSON kodlama/çözme struct'larını temizleyin.
- Swift kodu içindeki uzun SQL veya HTTP istemci çağrılarının tutarlı şekilde sarmalanmasını sağlayın.
app.get("hello") { req async throws -> String in
"Hello, world!"
}
Swift Öğretme & Öğrenme
Öğrencilere Swift'in deyimsel halinin nasıl göründüğünü gösterin ve alıştırmalardaki 'stil gürültüsünü' azaltın.
- Slaytlarda veya belgelerde örnek paylaşmadan önce Swift kodunu normalleştirin.
- Öğrenci gönderimlerini, mantık yerine boşluk ve girintiye odaklanmadan temizleyin.
- İyi biçimlendirmenin davranışı değiştirmeden okunabilirliği nasıl artırdığını gösterin.
func fibonacci(_ n: Int) -> Int {
if n < 2 { return n }
return fibonacci(n - 1) + fibonacci(n - 2)
}
❓ Frequently Asked Questions
❓Bu Swift Biçimlendirici gerçekte neyi değiştirir?
📏Sarmalama / Satır Uzunluğu için ne seçmeliyim?
🧹Bu, SwiftLint'in yerini mi alıyor?
🔒Üretim Swift kodunu buraya yapıştırmak güvenli mi?
⚡Bu biçimlendiriciyi her commit'te otomatik olarak çalıştırabilir miyim?
Pro Tips
Ekibinizle tek bir **Girinti Boyutu** ve **Satır Sarma / Uzunluğu** üzerinde anlaşın, ardından bu değerleri hem bu araçta hem de `.swiftformat` yapılandırmanızda yansıtın.
Kod incelemelerini boşluk tartışmaları yerine mantık ve mimariye odaklamak için biçimlendiriciyi pull request'lerde çalıştırın.
Üretilen Swift kodunda (ör. kod üretim araçlarından) biçimlendiriciyi kullanın, böylece el yazımı kodunuz kadar temiz görünsün.
Bu biçimlendiriciyi yalnızca hızlı yerel ayarlar için Xcode'un "Yeniden Girintile" özelliğiyle birleştirin; gerçekten tutarlı bir stil korumak için CI'da SwiftFormat'ı kullanın.
Additional Resources
Other Tools
- CSS Güzelleştirici
- HTML Güzelleştirici
- JavaScript Güzelleştirici
- PHP Güzelleştirici
- Renk Seçici
- Sprite Çıkarıcı
- Base64 Çözücü
- Base64 Kodlayıcı
- C# Biçimlendirici
- CSV Biçimlendirici
- Dockerfile Formatter
- Elm Biçimlendirici
- ENV Biçimlendirici
- Go Biçimlendirici
- GraphQL Biçimlendirici
- HCL Biçimlendirici
- INI Biçimlendirici
- JSON Biçimlendirici
- Latex Biçimlendirici
- Markdown Biçimlendirici
- ObjectiveC Biçimlendirici
- Php Formatter
- Proto Biçimlendirici
- Python Biçimlendirici
- Ruby Biçimlendirici
- Rust Biçimlendirici
- Scala Biçimlendirici
- Shell Script Biçimlendirici
- SQL Biçimlendirici
- SVG Biçimlendirici
- TOML Biçimlendirici
- Typescript Formatter
- XML Biçimlendirici
- YAML Biçimlendirici
- Yarn Biçimlendirici
- CSS Küçültücü
- Html Minifier
- Javascript Minifier
- JSON Küçültücü
- XML Küçültücü
- HTTP Başlıkları Görüntüleyici
- PDF'den Metne
- Regex Test Edici
- SERP Sıra Kontrolü
- Whois Sorgulama