Awesome GitHub RepositoriesPython Code Formatters

YAPF هي أداة تنسيق كود Python وأداة امتثال للأسلوب. تعمل كمُنسق قائم على AST يستخدم أشجار بناء الجملة الملموسة لضمان الاتساق الهيكلي وعرض مرئي موحد عبر ملفات المصدر. يستخدم المحرك مُحسِّن تخطيط قائماً على العقوبة لتحديد أفضل فواصل الأسطر عن طريق حساب تكاليف رقمية لخيارات التنسيق المختلفة. يستخدم معالج كود متعدد العمليات لتوزيع تنسيق ملفات متعددة عبر عدة أنوية CPU. تغطي الأداة إعادة تنسيق الكود المصدري من خلال تعديلات الملف في مكانه، وتحليل الفرق، ومعالجة أجزاء الكود الجزئية. تتضمن نظام تكوين قائماً على القواعد لإدارة إعدادات الأسلوب المسبقة، وقواعد التخطيط، وإعدادات مستوى المشروع. تشمل قدرات التكامل التحقق من امتثال الأسلوب لخطوط أنابيب التكامل المستمر، وأتمتة git hook، ووظيفة التنسيق عند الحفظ القائمة على المحرر.

Spotless هو منسق تنسيق متعدد اللغات وإضافة Gradle تقوم بأتمتة نمط الكود عبر لغات برمجة مختلفة ضمن خط أنابيب بناء واحد. يعمل كمنسق لمنسقات الطرف الثالث المتعددة، وأداة لتدقيق نمط الكود، ونظام لإدراج وتحديث ترويسات التراخيص الموحدة. يتميز المشروع بفرض النمط المدمج مع git، باستخدام خطافات ما قبل الدفع (pre-push hooks) ومراجع git لتطبيق التنسيق فقط على الملفات أو الأسطر المعدلة. يدعم تهيئات البناء المشتركة، مما يسمح بتوزيع قواعد التنسيق وتحميلها عبر مشاريع متعددة عبر أصول بعيدة للحفاظ على مصدر وحيد للحقيقة. تغطي الأداة مجموعة واسعة من الإمكانيات، بما في ذلك تحويل نص الكود المصدري عبر التعبيرات النمطية وتصحيحات JSON، وإدارة الاستيراد، وتوحيد المسافات البيضاء. تتكامل مع مجموعة واسعة من الملفات الثنائية والأدوات الخارجية للغات مثل Java وPython وKotlin وC++ وGo وTypeScript. تتضمن الوظائف الإضافية التحقق من التنسيق لضمان التكرارية والتحسين التزايدي لتخطي الملفات غير المتغيرة.

هذا المشروع عبارة عن مجموعة شاملة من مواد تعليم برمجة Python، بما في ذلك البرامج التعليمية، والتمارين، وعينات الكود المنسقة. يعمل كمنهج تعليمي ومجموعة أدوات هندسة برمجيات، باستخدام Jupyter Notebooks لدمج الكود القابل للتنفيذ مع نص تعليمي وصفي. يوفر المستودع أدلة تنفيذ عملية لبناء تطبيقات نماذج لغوية كبيرة، مثل أنظمة التوليد المعزز بالاسترجاع، ووكلاء الذكاء الاصطناعي ذوي الحالة، وسير عمل التعلم الآلي. يتميز بتقديم نهج منظم لسير عمل الترميز الوكيل، وتغطية تقطير نافذة السياق، وتوجيه النموذج المستقل عن المزود، والمخرجات المهيكلة المفروضة بالمخطط. تغطي المواد مجموعة واسعة من قدرات هندسة البرمجيات، بما في ذلك البرمجة غير المتزامنة مع طوابير المهام الموزعة، وتطوير تطبيقات الويب مع REST APIs، وسير عمل تحليل البيانات. كما يتضمن موارد لإتقان التصميم الموجه للكائنات، وتنفيذ خطوط أنابيب CI/CD، وتطبيق معايير التنسيق والتدقيق المهنية.

autopep8 هو مصحح أسلوب كود Python ساكن ومنسق مصمم لإعادة كتابة الكود المصدري تلقائيًا للامتثال لدليل أسلوب PEP 8. يعمل كمنظف كود عودي يحدد ويصلح المسافات البادئة، والمسافات البيضاء، ومخالفات البنية عبر المشاريع بأكملها. تقوم الأداة بإعادة هيكلة هيكلية باستخدام تحويلات شجرة البنية المجردة لتنفيذ تغييرات غير المسافات البيضاء، مثل تقصير الأسطر الطويلة وتحسين اختبارات الهوية. تتضمن وضع إعادة هيكلة قوي لمخالفات الأسلوب المعقدة وتدعم التنسيق الانتقائي عبر علامات مضمنة لتعطيل التغييرات لكتل كود محددة. تشمل القدرات تصفية الإصلاح القائمة على القواعد لاستهداف أو تجاهل رموز خطأ محددة، وتنسيق نطاق الأسطر، وتوليد تقارير فرق الأسلوب. يمكن للنظام معالجة الملفات من خلال واجهة سطر أوامر مع اجتياز الدليل العودي وتعديل الملف في مكانه، أو دمجه برمجيًا عبر API. يمكن إدارة تفضيلات التنسيق ومجموعات القواعد من خلال ملفات التكوين العالمية أو المحلية.

Proselint هو أداة تدقيق لغوي ومحلل نصوص قائم على القواعد، مصمم لتحديد الأخطاء الأسلوبية، والعبارات المبتذلة، والمصطلحات التقنية في النصوص المكتوبة. يقوم بمسح المستندات مقابل سجل منسق من القواعد اللغوية والطباعية للحفاظ على معايير التحرير المهنية وتحسين جودة الكتابة. يعمل المشروع كمعالج نصوص عبر سطر الأوامر، ومكتبة تحليل برمجية، وخطاف (hook) لعمليات git pre-commit. تسمح بنيته النمطية بدمج المحرك الأساسي في تطبيقات أخرى، أو عرضه عبر REST API، أو دمجه في محررات النصوص. تدعم الأداة التنقل العودي في المجلدات للتحليل الجماعي، وتقبل النصوص عبر المدخلات القياسية للاستخدام في خطوط أنابيب سطر الأوامر. كما توفر خيارات تكوين لتمكين أو تعطيل فحوصات لغوية محددة، ويمكنها تصدير نتائج التشخيص بتنسيق JSON مهيكل.

doctoc is a markdown table of contents generator and file processor designed to automatically create and update linked lists of headings within markdown documents. It functions as a git repository documentation tool that scans local directories to ensure navigation remains consistent across a collection of files. The tool features a GitHub compatible anchor generator that formats heading links to match the specific requirements of GitHub and similar hosting platforms. It manages updates by locating marker comments to replace existing tables of contents without overwriting other document conte

This project is a Python library and command-line tool designed to convert Markdown text and files into structured HTML fragments. It functions as a Markdown-to-HTML converter and parser that transforms piped text or source files into web-ready documents. The project is an extensible text processor featuring a pluggable API for defining custom inline and block syntax. This modular framework allows for the registration of specialized syntax extensions, such as tables and footnotes, and provides a system for managing runtime configuration settings. The conversion process covers multilingual te