تحميل gritql - تنزيل كود مصدر gritql

gritql

شفرة المصدر الأخرى

v0.1.0-alpha.1732682283

تنزيل

ملعب | البرنامج التعليمي | المستندات

GritQL هي لغة استعلام تعريفية للبحث عن كود المصدر وتعديله.

ابدأ ببساطة دون تعلم تفاصيل AST: أي مقتطف كود هو استعلام صالح لـ GritQL
⚡️ استخدم تحسين الصدأ والاستعلام لتوسيع نطاق ما يصل إلى 10 ملايين+ من مستودعات الخطوط
؟ استخدم نظام الوحدة المدمج في Grit لإعادة استخدام أكثر من 200 نمط قياسي أو مشاركة النمط الخاص بك
♻️ بمجرد أن تتعلم GritQL، يمكنك استخدامه لإعادة كتابة أي لغة مستهدفة: JavaScript/TypeScript أو Python أو JSON أو Java أو Terraform أو Solidity أو CSS أو Markdown أو YAML أو Rust أو Go أو SQL
؟ يعمل GritQL على تسهيل تضمين قواعد الإصلاح التلقائي من أجل معالجة أسرع

ابدء

اقرأ الوثائق أو البرنامج التعليمي التفاعلي أو قم بتشغيل grit --help .

تثبيت

تثبيت Grit CLI:

 curl -fsSL https://docs.grit.io/install | bash

الاستخدام

ابحث عن جميع مكالمات console.log الخاصة بك عن طريق وضع النمط المطلوب في علامات الظهر:

 grit apply '`console.log($_)`'

استبدل console.log بـ winston.log ، باستخدام => لإنشاء عمليات إعادة الكتابة:

 grit apply '`console.log($msg)` => `winston.log($msg)`'

احفظ النموذج في ملف grit.yaml واستثني حالات الاختبار في عبارة Where:

 cat << 'EOF' > .grit/grit.yaml
patterns:
  - name: use_winston
    level: error
    body: |
      `console.log($msg)` => `winston.log($msg)` where {
        $msg <: not within or { `it($_, $_)`, `test($_, $_)`, `describe($_, $_)` }
      }
EOF
grit apply use_winston

قم بتشغيل grit check لفرض أنماطك كخطوط مخصصة.

 grit check

أمثلة

قم بإزالة كافة استدعاءات `console.log` ، إلا إذا كانت داخل كتلة محاولة الالتقاط

 `console.log($log)` => . where {
  $log <: not within `try { $_ } catch { $_ }`
}

استبدل استدعاء الأسلوب باستدعاء أسلوب جديد

 `$instance.oldMethod($args)` => `$instance.newMethod($args)` where {
  $program <: contains `$instance = new TargetClass($_)`
}

لماذا GritQL؟

تأتي GritQL من تجاربنا في إجراء عمليات إعادة البناء والترحيل على نطاق واسع.

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

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

يجب التخلي عن معظم الأعمال الاستكشافية عندما تكتشف كيفية تمثيل بحث regex الأصلي الخاص بك على أنه AST.
تتطلب قراءة/كتابة كود مود ترجمة ذهنية من أسماء AST إلى الشكل الذي يبدو عليه كود المصدر فعليًا.
معظم الأطر غير قابلة للتركيب، لذا فأنت عالق في نسخ الأنماط ذهابًا وإيابًا.
غالبًا ما يكون الأداء فكرة لاحقة، لذا فإن التكرار على نظام كودي كبير يمكن أن يكون بطيئًا بشكل مؤلم.
إن أطر عمل Codemod خاصة باللغة، لذلك إذا كنت تتنقل بين لغات متعددة - أو تحاول ترحيل واجهة برمجة تطبيقات مشتركة - فيجب عليك تعلم أطر عمل مختلفة.

GritQL هي محاولتنا لتطوير حل وسط قوي:

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