psql rosetta

Btrieve / Pervasive.SQL / ZEN: مشروع مستودع مثال لرمز Rosetta

فكرة

قم بتوفير مثال رمزي موثق لجميع طرق الوصول إلى قاعدة البيانات التي يدعمها Pervasive.SQL على جميع الأنظمة الأساسية باستخدام جميع اللغات الشائعة. يفضل أن يكون مفيدًا لكل من المستخدم المبتدئ والمتقدم كدليل مرجعي.

اسم

يرى:

• حجر رشيد
• كود روزيتا

خلفية

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

تَخطِيط

استنادًا إلى الفقرة "طرق الوصول إلى قاعدة البيانات" في وثائق Actian Pervasive.SQL V13 عبر الإنترنت، قمت بإنشاء Bash Shellscript (mk_dirs.sh)، مع استخدام وسيطة واحدة هي اسم لغة البرمجة، مما يؤدي إلى إنشاء بنية دليل تسرد جميع طرق الوصول إلى قاعدة البيانات كأدلة فرعية. باستخدام هذا البرنامج النصي، اضطررت إلى النظر في جميع الاحتمالات (؟!) وتوثيقها بغض النظر عن مدى غرابتها. تحتوي جميع الدلائل الفرعية على ملف ReadMe التمهيدي الخاص بها والذي يصف الإمكانيات (im) والكود إذا تم توفيره. تحتوي جميع لغات البرمجة على ملف تخفيض السعر التمهيدي في دليلها الجذري الذي يصف التفاصيل الداخلية والخارجية، وما يتم تنفيذه وما لم يتم تنفيذه، بالإضافة إلى ملف تخفيض السعر الخاص بالنتائج لتسجيل ما تم اختباره على أي نظام أساسي.

الملفات المفقودة مقابل حقوق الطبع والنشر

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

التحسينات

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

• يجب أن تتوافق جميع التعليمات البرمجية مع معايير الترميز.
• إعادة هيكلة/تنظيف التعليمات البرمجية.
• يجب أن تكون جميع الأكواد غنية جدًا بالتعليقات. قم بتعليق جميع مكالمات قاعدة البيانات.
• يجب أن تكون جميع التعليمات البرمجية دفاعية للغاية: في حالة حدوث خطأ، يجب الإبلاغ عنه أو تسجيله على الأقل.
• يجب اختبار كافة التعليمات البرمجية بشكل صحيح. ويفضل أن يكون ذلك على جميع المنصات ذات الصلة. والتي بدورها ينبغي توثيقها.
• يجب كتابة التعليمات البرمجية أو تكييفها لمنصات أخرى. أبرزها: ماك، IOS، أندرويد
• بعض اللغات/الأنظمة الأساسية الواضحة مفقودة. على وجه الخصوص: Win/VS: c#، VB.net، Win/Embarcadero C++، Win/MingW أو غيرها من GNU C/C++، IOS/Objective C، Android/Java، Mac/جعل نصوص bash-shell متوافقة/داعمة.
• كما أن بعض اللغات التي كانت مدعومة/كانت مهمة لا تحتوي على نموذج التعليمات البرمجية حتى الآن. ما الذي يتبادر إلى ذهنك: كوبول، دلفي،...؟ وبعضها لم يعد مهمًا: (Visual) Basic (ما قبل .net)، Pascal، Turboc (DOS)، Watcom C/C++ (DOS)
• بعض "اللغات" ليست قابلة للإثبات بشكل كبير حيث يبدو أنها تتطلب تكاملًا شديدًا و/أو إدارة مشروع و/أو تكاملًا في بيئة تطوير متكاملة (IDE). ASP.NET مثال على ذلك.
• لم يتم سرد المنصات المتكاملة. على سبيل المثال، ربما لا يكون من المنطقي إدراجها في القائمة. المنصات الأخرى المستخدمة في الماضي: Clarion وPower Builder
• الموضوع الآخر الذي يتطلب الاهتمام هو التطوير على شبكة الإنترنت. يمكن للمرء أن يفكر في: Windows/ASP، وPython/Flask، وPython/Django، وRuby/Ruby-on-rails، وJavascript، وNodeJS. تم توسيعها اختياريًا بواسطة أطفال جدد في المجموعة مثل Dart/Flutter وMeteor وما إلى ذلك، على الرغم من أن الكثير منها يعتمد على Javascript.
• السائقين. حاليًا يتبادر إلى الذهن بشكل خاص: SQLAlchemy-Pervasive: يحتاج إلى بعض TLC الجاد.
• يتم التركيز حاليًا بشكل قوي على الاتصال بقاعدة البيانات. في نهاية المطاف، سيكون التطبيق الذي يدعم سطر الأوامر، واللعنات (TUI)، وواجهة المستخدم الرسومية أثناء استخدام جميع المكالمات المتاحة في واجهات برمجة التطبيقات (Btrieve، Btrieve2، ODBC، JDBC) بمثابة مكافأة حقيقية. من شأنه أن يلبي العرض التوضيحي، ويوضح كيفية استخدام المكالمات ومن الواضح أنه سيوفر اختبارًا رائعًا، خاصة إذا كان من الممكن تشغيل الكود باستخدام أتمتة الاختبار. سيكون هذا أمرًا رئيسيًا للتصميم والتنفيذ بشكل صحيح. بعض الخطوات الصغيرة في هذه العملية وحدها ستكون رائعة.

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

الاعتمادات

راجع ملف Credits.md. ينطبق هذا الملف على المشروع بأكمله.

رخصة

راجع ملف License.md. ينطبق هذا الملف على المشروع بأكمله.

تحذيرات

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