منصوبے کے بارے میں

SwiftFormat ایک کوڈ لائبریری اور کمانڈ لائن ٹول ہے جو macOS، Linux یا Windows پر Swift کوڈ کو دوبارہ فارمیٹ کرنے کے لیے استعمال ہوتا ہے۔ صرف خالی جگہوں کی ایڈجسٹمنٹ کے علاوہ، یہ خودکار `self` داخل یا ہٹا سکتا ہے، بے کار قوسین کو ختم کر سکتا ہے، اور معیاری Swift محاوروں سے کئی دیگر انحرافات کو درست کر سکتا ہے۔ پروجیکٹ کا بیان کردہ مقصد یہ ہے کہ مشترکہ کوڈنگ اسٹائل پر اتفاق تعاون میں مدد دیتا ہے، لیکن اسے دستی طور پر نافذ کرنا تھکا دینے والا اور غلطیوں کا شکار ہے۔ ایک خودکار فارمیٹر ٹیموں کو پیشکش کے بجائے کوڈ کے رویے پر توجہ دینے کی اجازت دیتا ہے۔ استعمال کے طریقے: - کمانڈ لائن ٹول، دستی طور پر یا ٹولچین کے حصے کے طور پر چلائیں - Xcode سورس ایڈیٹر ایکسٹینشن، ایڈیٹر > SwiftFormat مینو کے ذریعے - Xcode بلڈ فیز، ہر بلڈ پر چلتا ہے - Git پری-کمٹ ہک، کمٹ سے پہلے تبدیل شدہ فائلیں فارمیٹ کرتا ہے - Swift پیکیج مینیجر کمانڈ پلگ ان (Swift 5.6+) - VSCode (Run on Save کے ذریعے)، Sublime Text، اور Nova کے لیے انٹیگریشنز - GitHub Actions، CI پر Danger، Bazel، Docker، اور AppleScript تنصیب کے اختیارات میں Homebrew (`brew install swiftformat`)، Mint، Nix/nixpkgs، CocoaPods، Package.swift میں بائنری آرٹفیکٹ بنڈل، یا `swift build -c release` کے ساتھ دستی تعمیر شامل ہیں۔ Xcode ایکسٹینشن Homebrew cask یا GitHub Releases سے دستیاب ہے۔ بنیادی استعمال `swiftformat .` ہے جو موجودہ ڈائریکٹری میں Swift فائلوں کو فارمیٹ کرتا ہے۔ README میں خبردار کیا گیا ہے کہ یہ فائلوں کو براہ راست اوور رائٹ کرتا ہے، لہذا صارفین کو پہلے تبدیلیاں کمٹ کرنی چاہئیں؛ `--infer-options` موجودہ پروجیکٹ اسٹائل سے مماثل ترتیبات تجویز کر سکتا ہے۔ معیاری ان پٹ/آؤٹ پٹ پائپنگ معاون ہے، بشمول `--stdin-path` جو فائل کے مقام کا سیاق فراہم کرتا ہے۔ کنفیگریشن میں اختیارات، قواعد، Swift ورژن، ایک `.swiftformat` کنفیگ فائل، گلوبز، لِنٹنگ موڈ، ایرر کوڈز، کیشنگ، فائل ہیڈرز، اور مارک ڈاؤن فارمیٹنگ شامل ہیں۔ README میں FAQ، معلوم مسائل، ٹِپ جار، اور کریڈٹ بھی شامل ہیں۔ یہ پروجیکٹ MIT لائسنس یافتہ ہے۔