Code Metrics Tool

يقوم Code Metrics Tool بتحليل قاعدة الشفرة لقياس الجودة البنيوية باستخدام مقاييس البرمجيات القياسية. يحسب LOC، عدد الدوال، عدد الملفات، التعقيد الدوري، التبعيات، كثافة التعليقات ومؤشرات مستمدة من Halstead من لقطة الشفرة أو إدخال المستودع. الناتج يتضمن درجة ملخصة من 0 إلى 100 مع تفسير، إضافة إلى تفصيل حسب الملف عند الإتاحة. من حيث المفاهيم، يقوم بتطبيع العدادات إلى مؤشرات قابلة للفهم، يطبق صيغ معتمدة ويرفع المناطق عالية المخاطر. المدخلات المطلوبة هي LOC، الدوال، والملفات؛ البيانات الاختيارية حسب الملف تسمح بتقييم دقيق وتحديد النقاط الساخنة. التجميع يعطي درجة ملخصة، ومؤشر الصيانة، ومؤشر التعقيد، مع خيارات حسب الملف لتوجيه إعادة الهيكلة. الجمهور المستهدف يشمل المطورين وقادة الفرق والمعماريين ومديري المشاريع ومهندسي QA. القيمة الفريدة تكمن في الجمع بين القياسات الإجمالية ومقاييس الملف الواحد، وتوزين اللغة، ودعم الاتجاهات التاريخية وتنسيقات التصدير المرنة. حالات الاستخدام الشائعة: تمهيد وصول إلى شفرة جديدة، تتبع الدين عبر الإصدارات، ومقارنة الفرق. الميزات الأساسية: إدخال البيانات، حساب القياسات، التطبيع، تصنيف المخاطر بناءً على العتبات، وتحميل بيانات جاهزة لـ API. يركز Tool على الوضوح والتوجيه القابل للتنفيذ: يترجم القياسات إلى مستويات مخاطرة ونقاط ساخنة ذات أولوية، مما يتيح تحسينات مركّزة ودورات اتخاذ قرار أسرع. تنسيقات المدخلات المدعومة تشمل JSON وCSV للمدخلات وتنسيقات تصدير متعددة للمخرجات. صُمم للاستخدام عبر لغات ومشروعات بحجم متغير، مع خيارات وزن حسب الملف ومقارنات عبر المستودعات. اعتبارات الأمن والخصوصية: تُعالج بيانات الإدخال في الذاكرة؛ لا تُرسل البيانات دون تكوين API صريح؛ يمكن حفظ المخرجات محلياً. القيود: المقاييس مؤشرات اصطناعية وينبغي دمجها مع مراجعات الكود. التعليم: يوفر إرشادات تفسيرية وحدود أفضل الممارسات لمساعدة الفرق على إعطاء الأولوية لإعادة الهيكلة.