الوقت المقدّر لقراءة هذا المقال: 7 دقيقة و 14 ثانية

أطلق فريق مشروع الفانوس إصدارًا جديدًا من واجهته البرمجية (API) تعتمد على نظام مُخرجات جديد، بقاعدة برمجية مُوَّحَدَة له مُتَشَاركة بين كل من تطبيق الويب، سطح المكتب، CGI، أو عبر واجهة الصَّدَفة (Console interface). تحمل الاسم التشفيري «الحجر الأسود» .

ولمن لا يعرف معنى API، هي واجهة برمجية (لا رسومية) تسمح بنقل البيانات من مكتبة برمجية أو قاعدة البيانات أو محرك البحث على هيئة مُتعارف عليها بحيث تكون تلك الهيئة مفهومة من طرف عدة لغات برمجة على مختلف المنصات مثال ذلك XML وJSON.

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

يبقى هنا أمران:

كيف يتم بناء ملف الـ JSON وعلى أي أساس؟

من يوصل ذاك الـ JSON إلى التطبيق المنشود؟

أما البناء، فيكون بتعليم كل آية، اسمها، رقمها، سورتها، نوعها، موضوعها وجميع المعلومات الخاصة بها برقم أو مُتغير، ليكون الناتج وصفا مُلما بجميع الجوانب الدلالية، اللغوية والرقمية لتلك الآية، وإخراجه في ملف على هيئة JSON كما توضحه الصورة التالية:

أطلق مشروع الفانوس على هذا التخريج اسم JSON Output System أو اختصارا JOS، وقد تم توحيده في الإصدار الجديد وجعله مركزيا Centralized ، أي نفس النظام يخدم جميع أقسام المشروع، هذا يُسهل من عملية تطويره وإضافة الميزات عليه من مكان واحد.

تبقى مسألة من يوصل ناتج الـ JSON هذا إلى التطبيق المنشود؟ وهنا يأتي دور واجهات الفانوس، والتي تم تقسيمها حسب نوع التطبيقات

واجهة الصدفة Console Interface، يُمكن استدعاؤها من الحواسيب العادية وتطبيقات سطح المكتب، أو الطرفية.

واجهة خدمة الويب Web service Interface، يمكن استدعاؤها من طلبات http.

مكتبة بايثون، يمكن جلبها مباشرة في أي مشروع بايثون والاستفادة منها مباشرة في الشفرة البرمجية.

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

نداء الواجهة البرمجية الجديدة لا يقوم فقط على تمرير كلمات البحث أو نص الاستعلام، فقد تم أيضا إدراج مبدأ “الأعلام” Flags والتي عن طريقها يمكن تخصيص نتيجة الاستعلام وزيادة كفاءتها.

فمثلا لو أردت أن تكون نتيجة البحث مشكولة يُمكنك رفع راية Vocalized، ولو أردت النتائج مرتبة حسب معيار معين يمكنك رفع راية sorted مع قيمة معيار الترتيب، ولو أردت البحث عن تلك الكلمة وجذور الكلمة ومترادفاتها أيضا يمكنك رفع راية البحث المُبهم Fuzzy Search، وهكذا …

بعض مما تم ذكرة حتى الآن كان موجودا قبل الإصدارة الجديدة، إذا:

ماذا حملت الإصدارة الجديدة بالضبط ؟

لتلخيص الأمر فقد جاءت الإصدارة الجديدة بالتغيرات التالية، مع الحفاظ على التوافقية الرجعية Backward-compatibility مع الواجهة البرمجية السابقة:

تحسين في قائمة الأعلام flags وجعلها أكثر بداهة، حيث لا يُشترط رفع أو إعطاء قيم جميع الأعلام، أما تسمح في التحكم في كثافة النتائج.

إدراج رموز الأخطاء للإخبار عن حالة الاستعلام في حالة فشله أو نجاحه.

قابلية طلب معلومات الواجهة البرمجية الوصفية، يشمل ذلك معلومات عن: النسخة، رقمها، الرخصة، المؤلف، الترجمات والتلاوات المتوفرة، رسائل مساعدة وغير ذلك.

نظام اقتراحات قائم على: النطق القريب للكلمة، تشكيل مُغاير للكلمة، مشتقات الكلمة، مُرادفاتها.

إمكانية البحث وعرض النتائج بالكتابة اللاتينية للكلمة العربية باستعمال Buckwalter.

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

وحدات بحث متعددة، من ذلك بحث في الترجمات وبحث بالكلمة

إعادة تنظيم شاملة كاملة للشفرة المصدرية لملاءمتها مع معايير جودة الشفرة القياسية.

ما يُميز الفانوس:

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

قائم على عمل بحثي، وليس مجرد مسح على نص القرآن الكريم.

غني بالميزات وقابل ﻹثرائه بالمزيد منها.

الجدير بالإشارة أيضا، أن مؤسس المشروع ، عاصم شلي، قام مؤخرا بعمل فيديو شاملة تشرح أقسام المشروع، كيفية تجهيزه للتجريب المحلي، وكيفية استدعاء مختلف الواجهات البرمجية.

ساهم في إخراج هده الإصدارة:

قائمة المساهمين في المشروع ككل موجودة هنا

لمعرفة المزيد حول الأمر:

صفحة الإصدار على Github

وثيقة تشرح آلية عمل الواجهة البرمجية بشكل مُفصّل

مرتبط

اقرأ أيضا