عن المشروع

SwiftFormat هي مكتبة برمجية وأداة سطر أوامر لإعادة تنسيق كود Swift على macOS أو Linux أو Windows. بالإضافة إلى ضبط المسافات البسيط، يمكنها إدراج أو إزالة `self` الضمنية، وإزالة الأقواس الزائدة، وتصحيح العديد من الانحرافات الأخرى عن أساليب Swift القياسية. الدافع المعلن للمشروع هو أن الاتفاق على نمط ترميز مشترك يساعد في التعاون، لكن فرضه يدويًا أمر ممل وعرضة للأخطاء. يسمح المنسق الآلي للفرق بالتركيز على سلوك الكود بدلاً من شكله. طرق استخدامه: - أداة سطر أوامر، تُشغَّل يدويًا أو كجزء من سلسلة أدوات - إضافة محرر Xcode المصدر، تُستدعى عبر قائمة Editor > SwiftFormat - مرحلة بناء Xcode، تعمل في كل بناء - خطاف Git قبل الالتزام، لتنسيق الملفات المتغيرة قبل الالتزام - مكون إضافي لأوامر Swift Package Manager (Swift 5.6+) - تكاملات لـ VSCode (عبر Run on Save)، وSublime Text، وNova - GitHub Actions، وDanger على CI، وBazel، وDocker، وAppleScript تشمل خيارات التثبيت Homebrew (`brew install swiftformat`)، وMint، وNix/nixpkgs، وCocoaPods، وحزمة artifactbundle ثنائية في Package.swift، أو البناء يدويًا باستخدام `swift build -c release`. إضافة Xcode متاحة كصيغة Homebrew cask أو من إصدارات GitHub. الاستخدام الأساسي هو `swiftformat .` لتنسيق ملفات Swift في الدليل الحالي. يحذر README من أن هذا يستبدل الملفات في مكانها، لذا يجب على المستخدمين الالتزام بالتغييرات أولاً؛ يمكن لـ `--infer-options` اقتراح إعدادات تطابق نمط مشروع موجود. يتم دعم الأنابيب القياسية للإدخال/الإخراج، بما في ذلك `--stdin-path` لتوفير سياق موقع الملف. تغطي الإعدادات الخيارات والقواعد وإصدار Swift وملف إعداد `.swiftformat` وأنماط glob ووضع الفحص ورموز الأخطاء والتخزين المؤقت ورؤوس الملفات وتنسيق Markdown. يتضمن README أيضًا أسئلة شائعة ومشكلات معروفة وجرة إكرامية وإشادات. المشروع مرخص بموجب MIT.