تنزيل RefactorFirst - تنزيل رمز المصدر RefactorFirst

RefactorFirst

فئات أخرى

0.6.2

تنزيل

refactorfirst

ستساعدك هذه الأداة الخاصة بـ Java CodeBases في تحديد ما يجب أن تشيره أولاً:

دروس الله
دروس مقترنة للغاية
دورات الفصل (مع صور دورة!)

يقوم بمسح مستودع GIT الخاص بك ويدير:

حكم الطبقة الإله PMD
اقتران PMD بين الكائنات
تحليل الدورة على رمز المصدر الخاص بك باستخدام javaparser و jgrapht

يتم إجراء تحليل الدورة بناءً على أنواع حقل الفصل وأنواع توقيع الأسلوب في هذا الوقت (المزيد في المستقبل!).

ستبدو الرسوم البيانية التي تم إنشاؤها في التقرير مشابهة لهذا واحد: معلومات الصورة

يرجى ملاحظة: Java 11 (أو الأحدث) المطلوب لتشغيل RefactorFirst

هناك حاجة إلى التغيير في طلب Java 11 لمعالجة الضعف CVE-2023-4759 في JGIT
جافا 21 CodeBase تحليل دعم!

هناك عدة طرق لتشغيل التحليل على قاعدة كود:

من سطر الأوامر كتقرير HTML

قم بتشغيل الأمر التالي من جذر مشروعك (لا يلزم إنشاء رمز المصدر):

mvn org.hjug.refactorfirst.plugin:refactor-first-maven-plugin:0.6.1:htmlReport

عرض التقرير في target/site/refactor-first-report.html

كجزء من الإخراج الإجراءات github

سيؤدي ذلك إلى إنشاء تقرير HTML مبسط (لا توجد رسومات أو صور) كإخراج خطوة عمل GitHub

mvn -B clean test 
org.hjug.refactorfirst.plugin:refactor-first-maven-plugin:0.6.1:simpleHtmlReport 
&& echo " $( cat target/site/refactor-first-report.html ) " >> $GITHUB_STEP_SUMMARY

كجزء من البناء

أضف ما يلي إلى مشروعك في قسم الإنشاء. سوف تظهر showdetails مقاييس وتصنيفات فئة الله في الجدول الذي تم إنشاؤه.

< build >
    < plugins >
        ...
        < plugin >
            < groupId >org.hjug.refactorfirst.plugin</ groupId >
            < artifactId >refactor-first-maven-plugin</ artifactId >
            < version >0.6.1</ version >       
            <!-- optional -->
            < configuration >
                < showDetails >false</ showDetails >
            </ configuration >
        </ plugin >
        ...
    </ plugins >
</ build >

كتقرير Maven

أضف ما يلي إلى مشروعك في قسم التقارير.
سيظهر تقرير RefactorFirst في تقرير الموقع عند تشغيل mvn site

< reporting >
    < plugins >
        ...
        < plugin >
            < groupId >org.hjug.refactorfirst.plugin</ groupId >
            < artifactId >refactor-first-maven-plugin</ artifactId >
            < version >0.6.1</ version >       
        </ plugin >
        ...
    </ plugins >
</ reporting >

إذا رأيت خطأ مشابهًا لـ

 Execution default-site of goal org.apache.maven.plugins:maven-site-plugin:3.3:site failed: A required class was missing while executing org.apache.maven.plugins:maven-site-plugin:3.3:site: org/apache/maven/doxia/siterenderer/DocumentContent

ستحتاج إلى إضافة ما يلي إلى pom.xml الخاص بك:

  < build >
    < plugins >        
      < plugin >
        < groupId >org.apache.maven.plugins</ groupId >
        < artifactId >maven-site-plugin</ artifactId >
        < version >3.12.1</ version >
      </ plugin >
      < plugin >
        < groupId >org.apache.maven.plugins</ groupId >
        < artifactId >maven-project-info-reports-plugin</ artifactId >
        < version >3.4.5</ version >
      </ plugin >
    </ plugins >
  </ build >

لكنني أستخدم Gradle / Ly Project Layout ليس نموذجيًا!

أرغب في إنشاء مكون إضافي Gradle و (ربما) يدعم المشاريع غير التقليدية في المستقبل ، ولكن في غضون ذلك ، يمكنك إنشاء ملف POM وهمية في نفس الدليل مثل دليل .git الخاص بك:

< project xmlns = " http://maven.apache.org/POM/4.0.0 " xmlns : xsi = " http://www.w3.org/2001/XMLSchema-instance "
  xsi : schemaLocation = " http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd " >
  < modelVersion >4.0.0</ modelVersion >
 
  < groupId >com.mycompany.app</ groupId >
  < artifactId >my-app</ artifactId >
  < version >1.0-SNAPSHOT</ version >
</ project >

ثم (على افتراض تثبيت Maven) تشغيل

mvn org.hjug.refactorfirst.plugin:refactor-first-maven-plugin:0.6.1:htmlReport

عرض التقرير

عرض التقرير في target/site/refactor-first-report.html
بمجرد أن ينتهي المكون الإضافي من التنفيذ (قد يستغرق الأمر بعض الوقت للحصول على قاعدة كود كبيرة/قديمة) ، افتح هدف الملف/الموقع/Refactor-first-treport.html في جذر المشروع. سيحتوي على رسم بياني مشابه لتلك أعلاه ، وجدول يسرد فصول الله بالترتيب الموصى به بأنه يجب إعادة تمهيده. تعد الفصول الدراسية الموجودة في الجزء العلوي من اليسار من الرسم البياني هي الأسهل في إعادة تشكيلها مع وجود أكبر تأثير إيجابي على إنتاجية الفريق.
إذا تم اكتشاف فئات عالية الاقتران ، فسيتم إنشاء رسم بياني وجدول فئات مقترنة للغاية.

لدي التقرير. الآن ماذا ؟؟؟

اعمل مع مالك المنتج الخاص بك لتحديد أولويات الدين التقني الذي تم تحديده. قد يساعد ذلك في شرحها على أنها قيمة سلبية خفية تبطئ فريق Team.
إذا كان لديك intellij Ultimate ، فيمكنك تثبيت المكون الإضافي لمرجع Method Reference لمساعدتك في تحديد كيفية إعادة تصميم فصول الله المحددة والفصول المقترنة للغاية.

تفاصيل إضافية

سيعمل هذا المكون الإضافي على كل من الوحدة النمطية ومشاريع Maven متعددة الوحدات التي تحتوي على تخطيط مشروع Maven نموذجي.

تعتمد هذه الأداة على الورقة التي تحدد أولويات فرص الاستثمار في التصميم من قبل نيكو زازوروفيا ، وكارولين سيمان ، وفورست شول. يتوفر العرض التقديمي المستند إلى الورقة على https://resources.sei.cmu.edu/asset_files/presentation/2011_017_001_516911.pdf

القيود

وقتي. هذا مشروع شغف ويتم تطويره في وقت فراغي.

ردود الفعل والتعاون موضع ترحيب

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

خطط مستقبلية

تحسين تحليل دورة الدرجة (فقط أنواع أعضاء الحقل وأنواع توقيع الأسلوب يتم دعمها حاليًا).
إضافة مكون إضافي Gradle.
دمج مقاييس تغطية اختبار الوحدة لتحديد سلامة فصول إعادة الطرد بسرعة.
دمج تعداد الأخطاء لكل فئة لحساب التأثير (المحور ص).
دمج المزيد من التنافر من المقاييس الموجهة نحو الكائن في الممارسة (Lanza و Marinescu ، 2004).