automutate

السيارات

يطبق موجات الطفرات التي توفرها أدوات أخرى ، مثل المبيدات أو الترميز.

هناك العديد من المبيدات الموجودة هناك ، ويشمل معظمها طرقًا ل --fix الفشل تلقائيًا. هذا رائع ولكن من الصعب القيام به لعدة أسباب:

• الطفرات المتداخلة - تتطلب إمكانية تطبيق الطفرات المتقدمة على مجموعات متداخلة من الأحرف المنطق للتعامل مع تطبيق واحد ، ثم إعادة تشغيل linting ، وما إلى ذلك.
• Code Bloat Asplication - توفر معظم المبيدات إما خطافات لتطبيق الإصلاحات نفسها (والتي يمكن أن تؤدي إلى ارتفاع رمز) أو أن يكون لها مشروع خارجي (والذي يكرر المنطق لإيجاد القواعد).

تقترح automutate أن المبيدات تقترح فقط كيفية إصلاح القواعد ، من خلال تنسيق JSON موحد.

إن وجود مشروع موحد للمصدر الغامض لتطبيق الطفرات يجلب بعض الفوائد:

• انخفاض النفقات العامة - لم تعد المشاريع تحتاج إلى القيام بهذا العمل بأنفسهم.
• قاعدة موحدة - يتم تقليل وقت العملة للتبديل بين المشاريع باستخدام automutate باستخدام رمز مشترك.

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

كيف تعمل

بدأت خوارزمية automutate الرئيسية في autoMutator.ts وتطبيقها في الغالب في mutationsApplier.ts :

while mutationsWave = getMutationsWave ( ) :
    for ( file , fileMutations ) of groupMutationsByFile ( mutationsWave ) :
        for mutation of getNonOverlappingMutationsInReverse ( fileMutations ) :
            applyMutation ( file , mutation )

1. يستدعي getMutationsWave إلى أداة خارجية ، مثل Linter ، لتلقي موجة من الطفرات المقترحة.
2. groupMutationsByFile تنظم الطفرات المقترحة حسب الملف.
3. يزيل getNonOverlappingMutationsInReverse الطفرات المتداخلة التي من شأنها أن تتعارض مع بعضها البعض ، وفرز الباقي بترتيب عكسي بحيث لا تتداخل الطفرات اللاحقة مع مواقف شخصية الطفرات السابقة.
4. applyMutation يعدل الملفات على القرص باستخدام الطفرات المتبقية.

طفرات

تحتوي طفرة واحدة على معرف فريد type ، ومجموعة من موضع (موضع) الحرف لتطبيقها ، ومنطق آخر اختياريًا.

يتم توفير معالجة النص الأساسية التالية خارج الصندوق:

• multiple - حاوية لطفرات متعددة. يشير هذا إلى automutate أنه يجب تطبيقها على الفور أو لا على الإطلاق ، مما يضمن الاتساق مع اكتشاف تداخل الطفرة المدمج.
• text-delete - حذف مجموعة من الأحرف.
• text-insert - إدراج سلسلة عند نقطة واحدة.
• text-replace - يحل محل الأحرف المطابقة لسلسلة أو تعبير منتظم داخل نطاق.
• text-swap - تبادل مجموعة من الأحرف مع سلسلة جديدة.

على سبيل المثال:

{
  "ugly-file.txt" : [
    {
      "range" : {
        "begin" : 7 ,
        "end" : 14
      },
      "type" : " text-delete "
    },
    {
      "insertion" : " inconceivable! " ,
      "range" : {
        "begin" : 21
      },
      "type" : " text-insert "
    }
  ]
}

قد تحدد الأدوات المساعدة الخاصة بـ Linter طفراتها الخاصة. على سبيل المثال ، قد يحدد عمود اللغة طفرة node-rename بدلاً من استخدام طفرة multiple تحتوي على طفرات text-swap .

انظر الطبعات لمعرفة المزيد عن المسخات المخصصة.

مشروع على متن الطائرة

انظر على متن الطائرة.

يتطلب automutate nodejs> = 14.