بيرلسورس - عبر الإنترنت في السحابة

برنامج:

اسم

بيرلسورس - دليل لشجرة مصدر بيرل

الوصف

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

العثور على بتحديث WAY حول

شجرة مصدر بيرل كبيرة. وإليك بعض ما ستجده فيه:

C الكود
معظم التعليمات البرمجية المصدر وملفات الرأس موجودة في جذر الشجرة المصدر. هناك
عدد قليل من الدلائل الخاصة بالنظام الأساسي والتي تحتوي على كود C. بالإضافة إلى بعض الوحدات
يتم شحنها مع لغة Perl وتتضمن رمز C أو XS.

راجع perlinterp لمزيد من التفاصيل حول الملفات التي يتكون منها مترجم Perl، بالإضافة إلى
تفاصيل حول كيفية عمله.

جوهر نماذج
الوحدات التي يتم شحنها كجزء من لغة Perl الأساسية تعيش في أربعة أدلة فرعية. اثنان من هؤلاء
تحتوي الدلائل على وحدات موجودة في المركز، ويحتوي اثنان منها على وحدات يمكنها ذلك أيضًا
سيتم إصداره بشكل منفصل على CPAN. تُعرف الوحدات التي يمكن إصدارها على cpan باسم "dual-
وحدات الحياة ".

· ليب /

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

· تحويلة /

اعجاب ليب /، يحتوي هذا الدليل على وحدات تم إصدارها فقط كجزء من ملف
جوهر. على عكس ليب /ومع ذلك، وحدة تحت تحويلة / بشكل عام يحتوي على دليل على نمط CPAN-
وتخطيط الملف والخاصة بها Makefile.PL. ليس هناك توقع أن وحدة تحت
تحويلة / ستعمل مع الإصدارات السابقة من Perl 5. ومن ثم، قد تكتمل هذه الوحدة
الاستفادة من التحسينات النحوية وغيرها في Perl 5 blead.

· حي /

هذا الدليل مخصص للوحدات النمطية ذات الحياة المزدوجة حيث يكون مصدر النزيف أساسيًا. لاحظ أن
ربما لم يتم إصدار بعض الوحدات في هذا الدليل بشكل منفصل على CPAN.
وحدات تحت حي / ينبغي بذل جهد للعمل مع الإصدارات السابقة من Perl 5.

· cPan /

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

بالنسبة لبعض الوحدات ذات الحياة المزدوجة، لم يتم تحديد ما إذا كان إصدار CPAN أم لا
مصدر النزيف هو الكنسي. وإلى أن يتم ذلك، يجب أن تكون هذه الوحدات موجودة cPan /.

اختبارات
يحتوي جوهر Perl على مجموعة اختبار واسعة النطاق. إذا قمت بإضافة اختبارات جديدة (أو وحدات جديدة مع
الاختبارات)، قد تحتاج إلى تحديث ر / اختبار الملف حتى يتم تشغيل الاختبارات.

· اختبارات الوحدة

اختبارات الوحدات الأساسية في ليب / الدليل بجوار الوحدة نفسها مباشرةً. ل
على سبيل المثال، لدينا ليب/صارم.pm ليب/صارم.t.

اختبارات للوحدات في تحويلة / ووحدات الحياة المزدوجة موجودة t/ الدلائل الفرعية لكل
الوحدة النمطية، مثل توزيع CPAN القياسي.

· ر / قاعدة /

اختبارات الوظيفة الأساسية المطلقة لـ Perl. يتضمن هذا الملف الأساسي "if".
القراءة والكتابة والتعابير البسيطة وما إلى ذلك. يتم تشغيلها أولاً في مجموعة الاختبار وif
أي منهم تفشل، شيء ما في الحقيقة مكسورة.

· ر/كمد/

اختبارات لهياكل التحكم الأساسية، "إذا/آخر"، "بينما"، الإجراءات الفرعية، وما إلى ذلك.

· ر / شركات /

اختبارات للمشكلات الأساسية المتعلقة بكيفية تحليل لغة Perl وتجميعها لنفسها.

· ر / إيو /

اختبارات وظائف الإدخال والإخراج المضمنة، بما في ذلك وسائط سطر الأوامر.

· ر/مرو/

اختبارات لتطبيقات ترتيب دقة طريقة Perl (انظر MRO).

· قمة/

اختبارات لوظائف Perl المضمنة التي لا تتناسب مع أي من الدلائل الأخرى.

· ر/أوباسيك/

اختبارات وظائف Perl المضمنة، مثل تلك الموجودة في قمة/، لا تتناسب مع أي من
الدلائل الأخرى، ولكن، بالإضافة إلى ذلك، لا يمكن استخدامها ر/test.pl، مثل هذا البرنامج
يعتمد على الوظيفة التي يختبرها ملف الاختبار نفسه.

· ر / إعادة /

اختبارات للوظائف أو السلوك المتعلق بالتعبير العادي. (كانت هذه تعيش في t/op).

· ر/تشغيل/

اختبارات لميزات كيفية تشغيل لغة Perl فعليًا، بما في ذلك رموز الخروج والتعامل مع
بيرل * متغيرات البيئة.

· ر/يوني/

اختبارات الدعم الأساسي لليونيكود.

· ر/win32/

اختبارات خاصة بنظام التشغيل Windows.

· ر / ترقية /

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

· ر/ليب/

المنزل القديم لاختبارات الوحدة، لا ينبغي أن تضع أي شيء جديد هنا. هناك
لا تزال هناك بعض القطع والأجزاء المعلقة هنا والتي تحتاج إلى النقل. ربما أنت
يمكن أن تتحرك لهم؟ شكرًا!

توثيق
جميع الوثائق الأساسية المخصصة للمستخدمين النهائيين موجودة في جراب/. الوحدات الفردية في
ليب /, تحويلة /, حي /و cPan / عادة ما يكون لديهم وثائقهم الخاصة، إما في الوحدة. مساء
الملف أو المرافقة Module.pod ملف.

أخيرًا، توجد الوثائق المخصصة لمطوري Perl الأساسيين في النقل/ الدليل.

القرصنة أدوات توثيق
تشير ترقية يحتوي الدليل على حقيبة من التعليمات البرمجية والوثائق المخصصة للمساعدة
يعمل الحمالون على لغة بيرل. تشمل بعض النقاط البارزة ما يلي:

· يفحص*

هذه هي البرامج النصية التي ستتحقق من الأشياء المصدر مثل انتهاكات ANSI C وPOD
مشاكل الترميز، الخ.

· عمال الصيانة, المشرفين.plو المشرفين. مساء

تحتوي هذه الملفات على معلومات حول من يحتفظ بالوحدات النمطية. قم بتشغيل "بيرل
Porting/Maintainers -M Module::Name" لمعرفة المزيد من المعلومات حول الحياة المزدوجة
وحدة.

· com.podtidy

يرتب ملف جراب. إنها فكرة جيدة أن تقوم بتشغيل هذا على ملف pod الذي قمت بتصحيحه.

البناء نظام
يبدأ نظام بناء Perl بـ ضبط البرنامج النصي في الدليل الجذر.

توجد أيضًا أجزاء نظام البناء الخاصة بالنظام الأساسي في الدلائل الخاصة بالنظام الأساسي
مثل Win32/, أجهزة افتراضية/، الخ.

تشير ضبط البرنامج النصي هو المسؤول في النهاية عن إنشاء ملف ماكيفيلي.

نظام البناء الذي يستخدمه Perl يسمى metaconfig. تتم صيانة هذا النظام بشكل منفصل
من جوهر بيرل.

يحتوي نظام metaconfig على مستودع git الخاص به. يرجى الاطلاع على ملف README الخاص به
<http://perl5.git.perl.org/metaconfig.git/> لمزيد من التفاصيل.

تشير عبر يحتوي الدليل على ملفات متنوعة تتعلق بالتجميع المتقاطع لـ Perl. يرى
الصليب/الملف التمهيدي لمزيد من التفاصيل.

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

قائمة
تشير قائمة يحتوي الملف الموجود في جذر الشجرة المصدر على قائمة بكل ملف في ملف Perl
الأساسية، فضلا عن وصف موجز لكل ملف.

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

% Perl -lne 'print if /^[^\/]+\.[ch]\s+/' البيان

استخدم Perlsource عبر الإنترنت باستخدام خدمات onworks.net