cgql

com.cgql

لغة استعلام مستوحاة من GraphQL لنقل البيانات بين Clojure وClojureScript.

تنصل

ولد هذا المشروع في سعيي لتعلم Clojure. تعجبني الفكرة وأخطط لتطويرها بشكل أكبر في الأشهر التالية. في المرحلة الحالية يعد الأمر خامًا جدًا بحيث لا يمكن استخدامه في أي مشروع بخلاف المتعة. أي اقتراحات وردود الفعل هي موضع ترحيب!

قصة

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

ماذا يمكن أن تفعل

• قم بوصف واجهة برمجة التطبيقات الخاصة بك وربط التنفيذ في خريطة واحدة بسيطة
• قم بإنشاء المستندات بواسطة تلك الخريطة
• التحقق من صحة الطلبات والاستجابات باستخدام وحدات (clojure.spec).
• يدعم التداخل غير المحدود والمراجع للاستعلامات
• يدعم سياق الخادم للطلب (مثل الجلسات)
• يدعم التسلسل التلقائي وإلغاء التسلسل في أي بنية Clojure أصلية باستخدام edn. يمكنك أيضًا الحصول على بنيات مخصصة باستخدام 'cljs.reader/register-tag-parser!'

(نعم، كل ذلك في حوالي 350 سطرًا من التعليمات البرمجية، مع التعليقات)

كيفية قراءتها

الكود الرئيسي موجود داخل ملف "core.cljc" ومثال على استخدامه موجود في ملف "cgql-demo.cljc".

التالي

1. اكتب بعض المشاريع المفضلة لديك باستخدام هذا للتحقق من الافتراضات (لا توجد قوائم مهام!) حول سهولة الاستخدام.
2. مع المعرفة من المشروع، قم بإجراء التغييرات المطلوبة وقم بالتغطية بالاختبارات.
3. توثيق واستخدام المزيد.

أشياء عظيمة لم يتم تنفيذها (ولكن قد يتم تنفيذها يومًا ما)

1. القدرة على توليد القيم بدون خادم باستخدام المولدات للمواصفات.
2. مولد الوثيقة
3. مترجم إلى GrapgQL لتطبيقات iOS الضعيفة التي ليس لديها طريقة لتشغيل Clojure بسهولة.