antlr4

أنتلر v4

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

حالة بناء فرع التطوير

(إجراءات جيثب)

الإصدار

يدعم ANTLR 4 10 لغات مستهدفة (Cpp، وCSharp، وDart، وJava، وJavaScript، وPHP، وPython3، وSwift، وTypeScript، وGo)، ويعد ضمان الاتساق عبر هذه الأهداف ميزة فريدة وقيمة للغاية. لضمان الدعم المناسب لهذه الميزة، يعد كل إصدار من ANTLR إصدارًا كاملاً للأداة وأوقات التشغيل العشرة، وكلها بنفس الإصدار. على هذا النحو، لا يتبع إصدار ANTLR بشكل صارم دلالات سيمفر:

• قد يتم إصدار مكون بأحدث رقم إصدار على الرغم من عدم تغيير أي شيء داخل هذا المكون منذ الإصدار السابق
• يتم تغيير الإصدار الرئيسي فقط عند إعادة كتابة ANTLR لـ "جيل" جديد تمامًا، مثل ANTLR3 -> ANTLR4 (LL(*) -> تحليل ALL(*))
• قد تتضمن تحديثات الإصدار الثانوية تغييرات طفيفة، وتتمثل السياسة في إعادة إنشاء المحللين مع كل إصدار (4.11 -> 4.12)
• التوافق مع الإصدارات السابقة مضمون فقط في حالة نتوءات إصدار التصحيح (4.11.1 -> 4.11.2)

إذا كنت تستخدم أداة التحقق semver في CI الخاص بك، فمن المحتمل أنك تريد تطبيق قواعد خاصة لـ ANTLR، مثل التعامل مع التغيير البسيط باعتباره تغييرًا كبيرًا.

هيكل فرع الريبو

الفرع الافتراضي لهذا الريبو هو master ، وهو أحدث إصدار مستقر ويحتوي على علامات للإصدارات المختلفة؛ على سبيل المثال، راجع علامة الإصدار 4.9.3. فرع dev هو المكان الذي يحدث فيه التطوير بين الإصدارات ويجب أن تكون جميع طلبات السحب مستمدة من هذا الفرع. يُدمج فرع dev مرة أخرى في master لقص إصدار ويتم وضع علامة على حالة الإصدار (على سبيل المثال، بـ 4.10-rc1 أو 4.10 .) بصريًا، تبدو عمليتنا تقريبًا كما يلي:

أصبح لهدف Go الآن مستودع خاص به:

$ go get github.com/antlr4-go/antlr

ملاحظة: Go repo المخصص مخصص go get import فقط. لا يزال يتم تنفيذ تطوير وقت تشغيل Go في مستودع antlr/antlr4 الرئيسي.

المؤلفين والمساهمين الرئيسيين

• تيرينس بار، [email protected] قائد مشروع ANTLR والدكتاتور الأعلى مدى الحياة جامعة سان فرانسيسكو
• Sam Harwell (مؤلف مشارك للأداة، Java وهدف C# الأصلي)
• إريك فيرجنود (أهداف Javascript وTypeScript وPython2 وPython3 وصيانة هدف C#)
• بيتر بوير (اذهب إلى الهدف)
• مايك ليشكي (الهدف المكتمل لـ C++)
• دان ماكلولين (الهدف الأولي لـ C++)
• ديفيد سيسون (الهدف والاختبار الأولي لـ C++)
• جانيو (الهدف السريع)
• إيوان ميلور، هانتشو شي (دمج الهدف السريع)
• Ben Hamilton (دعم Unicode الكامل في ATN التسلسلي وأوقات تشغيل جميع اللغات لنقاط التعليمات البرمجية > U+FFFF)
• ماركوس باسوس (هدف PHP)
• لينغيو لي (هدف دارت)
• قدم إيفان كوشوركين مساهمات كبيرة في الجودة الشاملة ومعالجة الأخطاء والأداء المستهدف.
• لقد قام جاستن كينغ بقدر كبير من العمل عبر أهداف متعددة، ولكن بشكل خاص بالنسبة لـ C++.
• يتمتع كين دومينو بموهبة العثور على الأخطاء/المشكلات والتحليل؛ وهو أيضًا مساهم رئيسي في grammars-v4 repo.
• ساهم Jim Idle في الإصدارات السابقة من ANTLR وعاد مؤخرًا لحل مشكلة كبيرة تتعلق بهدف Go.

معلومات مفيدة

• ملاحظات الإصدار
• الشروع في العمل مع v4
• الموقع الرسمي
• التوثيق
• التعليمات
• أهداف إنشاء كود ANTLR
  (حاليًا: Java، C#، Python3، JavaScript، TypeScript، Go، C++، Swift، Dart، PHP)
• ملاحظة: اعتبارًا من الإصدار 4.14، سنتوقف عن دعم Python 2. نحن نحب مجتمع Python، ولكن تم إيقاف دعم Python 2 رسميًا في يناير 2020. ومؤخرًا، أسقطت GiHub أيضًا دعم Python 2، مما جعل ذلك مستحيلًا بالنسبة لنا. للحفاظ على مستوى ثابت من الجودة عبر الأهداف (نستخدم GitHub لـ CI الخاص بنا). تحيا بايثون 3!
• جافا API
• أنتلر v3
• الهجرة من الإصدار الثالث إلى الإصدار الرابع، الاختلافات

قد تجد أيضًا الصفحات التالية مفيدة، خاصة إذا كنت تريد التلاعب باللغات المستهدفة المختلفة.

• كيفية بناء ANTLR نفسه
• كيف نقوم بإنشاء ونشر إصدار ANTLR

المرجع النهائي ANTLR 4

يواجه المبرمجون مشكلات التحليل طوال الوقت. سواء أكان ذلك تنسيق بيانات مثل JSON، أو بروتوكول شبكة مثل SMTP، أو ملف تكوين خادم لـ Apache، أو ملف PostScript/PDF، أو لغة ماكرو بسيطة لجداول البيانات - ANTLR v4 وهذا الكتاب سوف يزيل الغموض عن العملية. تمت إعادة كتابة ANTLR v4 من البداية لتسهيل إنشاء المحلل اللغوي وتطبيقات اللغة المبنية في الأعلى أكثر من أي وقت مضى. يوضح لك هذا الإصدار الجديد المعاد كتابته بالكامل من مرجع ANTLR النهائي الأكثر مبيعًا كيفية الاستفادة من هذه الميزات الجديدة.

يمكنك شراء الكتاب The Definitive ANTLR 4 Reference على أمازون أو نسخة إلكترونية على موقع الناشر.

ستجد كود مصدر الكتاب مفيدًا.

قواعد نحوية إضافية

هذا المستودع عبارة عن مجموعة من القواعد النحوية بدون إجراءات حيث يكون اسم الدليل الجذر هو الاسم الصغير بالكامل للغة التي تم تحليلها بواسطة القواعد. على سبيل المثال، Java، CPP، CSharp، C، إلخ ...