About the project

حوّل «المعالجة المسبقة»
إلى طبقة قابلة للتحقق

بدأ CrucibleCpp بسؤال محدد جدًا: عندما يحتاج نظام البناء إلى نتيجة معالجة مسبقة مستقلة، هل يمكنه ألا يعتمد على g++ -E في استدعاءات العمليات، مع الحصول في الوقت نفسه على مخرجات موثوقة وقابلة للتفسير وقابلة للاختبار الارتدادي؟

لماذا معالج مسبق مستقل

تبدو المعالجة المسبقة مجرد «توسيع ماكرو»، لكن المشاريع الحقيقية تحوّلها إلى تقاطع التشخيص والاعتماديات وPCH ومجموعات المحارف وحالة الماكرو والتخزين المؤقت للبناء. ولا يمكن ملاحظتها واختبارها وتحسينها بمعزل إلا بعد فصلها في طبقة مستقلة.

ليس هدف CrucibleCpp إعادة كتابة المترجم، بل تحويل مراحل الترجمة 1–4 إلى مكوّن ذي حدود واضحة وسلوك قابل للمقارنة المباشرة.

مبادئ التصميم

  • السلوك يُقاس على GCC. ليس «يبدو معقولًا»، بل يُتحقق منه مقابل GCC حقيقي.
  • يجب ترجمة كل حالة إيجابية وتشغيلها. نجاح المعالجة المسبقة لا يعني أن المخرجات قابلة للاستخدام.
  • لا تُخلط الإصدارات. يجب أن يتطابق ملف تعريف GCC الهدف وترويساته وأوامر الترجمة.
  • لا تُخفى القيود. تُذكر القدرات غير المدعومة صراحةً، ولا يُستخدم «يُفترض أنه يعمل» بديلًا عن التحقق.
  • Windows x64 أولًا. اجعل هدفًا واحدًا موثوقًا أولًا، ثم تحدّث عن التوافق عبر المنصات.
Status

الحالة الحالية

  • الإصدار: V3.0.1
  • المنصة: Windows x64 / UCRT64
  • GCC الهدف: 13.3 / 14.3 / 15.2
  • المعايير: C++11 / 14 / 17 / 20
  • الاختبارات: ثلاث مجموعات 65/65
  • الترخيص: CC BY-NC 4.0
الكود المصدري لهذا الموقع غير متاح للعموم حاليًا. ويظل مستودع GitHub هو المرجع لكود منتج CrucibleCpp ومعلومات الإصدار.
فتح مستودع GitHub
Author

TomatoOyster

مطوّر مستقل. يهتم بسلسلة أدوات C++ وأنظمة البناء والبنية التحتية الهندسية القابلة للتحقق.

Project

CrucibleCpp

معالج C++ مسبق مستقل لنظام Windows x64، هدفه استبدال خطوة g++ -E في مسار البناء.

Contact

GitHub

تُتابَع الأسئلة والاقتراحات ومعلومات الإصدار عبر GitHub Issues / Releases.

إرسال Issue →