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

برنامج:

اسم

cpanm - الحصول على الوحدات النمطية من CPAN وفك حزمها وتركيبها

موجز

اختبار cpanm :: More # install Test :: More
cpanm MIYAGAWA / Plack-0.99_05.tar.gz # مسار التوزيع الكامل
com.cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # تثبيت من URL
com.cpanm ~ / dists / MyCompany-Enterprise-1.00.tar.gz # تثبيت من ملف محلي
cpanm - مهمة تفاعلية :: Kensho # تكوين بشكل تفاعلي
cpanm. # تثبيت من الدليل المحلي
cpanm - installdeps. # تثبيت جميع الأقسام للدليل الحالي
cpanm -L extlib Plack # install Plack وجميع الأقسام غير الأساسية في extlib
cpanm - المرآة http://cpan.cpantesters.org/ DBI # استخدم المرآة سريعة المزامنة
cpanm - من https://cpan.metacpan.org/ Plack # استخدم فقط مرآة HTTPS

أوامر

(الحجج)
يمكن أن تكون وسيطات سطر الأوامر إما اسم وحدة نمطية أو ملف توزيع أو ملف محلي
المسار أو عنوان URL لـ HTTP أو عنوان URL لمستودع git. ستعمل جميع الأوامر التالية كما تتوقع.

cpanm بلاك
cpanm Plack / Request.pm
cpanm MIYAGAWA / Plack-1.0000.tar.gz
cpanm /path/to/Plack-1.0000.tar.gz
com.cpanm http://cpan.metacpan.org/authors/id/M/MI/MIYAGAWA/Plack-0.9990.tar.gz
بوابة cpanm: //github.com/plack/Plack.git

بالإضافة إلى ذلك ، يمكنك استخدام الترميز باستخدام "~" و "@" لتحديد إصدار لملف
وحدة معينة. يحدد "~" متطلبات الإصدار في تنسيق CPAN :: Meta :: Spec ،
بينما يقوم "@" بتثبيت الإصدار الدقيق ، وهو اختصار لـ "~" == VERSION "".

cpanm Plack ~ 1.0000 # 1.0000 أو أحدث
cpanm Plack ~ "> = 1.0000 ، <2.0000" # الأحدث من 1.xxxx
com.cpanm [البريد الإلكتروني محمي] # إصدار محدد. مثل Plack ~ "== 0.9990"

سيتم إرسال استعلام الإصدار بما في ذلك الإصدار أو النطاق المحدد إلى MetaCPAN إلى
البحث عن الإصدارات السابقة. سيبحث الاستعلام عن أرشيفات BackPAN افتراضيًا ،
ما لم تحدد الخيار "--dev" ، في هذه الحالة ، سيتم تصفية الإصدارات المؤرشفة
خارج.

بالنسبة لمستودع git ، يمكنك تحديد فرع أو علامة أو تنفيذ SHA للإنشاء. ال
الافتراضي هو "رئيسي"

بوابة cpanm: //github.com/plack/[البريد الإلكتروني محمي] # بطاقة شعار
بوابة cpanm: //github.com/plack/Plack.git@devel # فرع

-أنا ، - تثبيت
يثبت الوحدات. هذا هو السلوك الافتراضي وهذا مجرد توافق
خيار لجعله يعمل مثل cpan أو cpanp.

- الترقية الذاتية
ترقيات نفسها. إنه مجرد اسم مستعار لـ:

تطبيق cpanm :: cpanminus

--معلومات
يعرض معلومات التوزيع بتنسيق "AUTHOR / Dist-Name-ver.tar.gz" بتنسيق
معيار بها.

- التثبيت
يقوم بتثبيت تبعيات التوزيع المستهدف ولكنه لن يبني نفسه. مفيد إذا
تريد تجربة التطبيق من مستودع يتم التحكم فيه بالإصدار مثل git.

cpanm - installdeps.

--ينظر
قم بتنزيل وفك ضغط التوزيع ثم افتح الدليل باستخدام قشرتك.
يسهل عليك الالتفاف حول الكود المصدري أو إجراء اختبار يدوي.

-h ، - مساعدة
يعرض رسالة المساعدة.

-V ، - الإصدار
يعرض رقم الإصدار.

OPTIONS

يمكنك تحديد الخيارات الافتراضية في متغير البيئة "PERL_CPANM_OPT".

-f ، - القوة
فرض وحدات التثبيت حتى عند فشل الاختبار.

-n ، --Nest
تخطي اختبار الوحدات. استخدم هذا فقط عندما تريد توفير الوقت فقط
تثبيت مئات التوزيعات على نفس بيرل والعمارة التي قمت بها بالفعل
تم اختباره للتأكد من أنه يبني بشكل جيد.

الإعدادات الافتراضية على خطأ ، ويمكنك أن تقول "- no-notest" للتجاوز عندما يتم تعيينها في
الخيارات الافتراضية في "PERL_CPANM_OPT".

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

لاحظ أنه إذا قمت بتحديد هذا الخيار مع وحدة نمطية أو توزيع يحتوي على
التبعيات ، سيتم تثبيت هذه التبعيات إذا لم يكن لديك حاليًا.

-S ، --sudo
قم بالتبديل إلى المستخدم الجذر باستخدام "sudo" عند تثبيت الوحدات. استخدم هذا إذا كنت تريد ذلك
تثبيت وحدات لنظام بيرل تشمل المسار.

الإعدادات الافتراضية على false ، ويمكنك أن تقول "--no-sudo" للتخطي عندما تكون مضبوطة في ملف
الخيارات الافتراضية في "PERL_CPANM_OPT".

-v ، - الإسراف
يجعل الإخراج مطولاً. كما أنه يتيح التكوين التفاعلي. (يرى
- تفاعلي)

-Q ، - هادئ
يجعل الإخراج أكثر هدوءًا من الافتراضي. يظهر فقط النجاح / الفاشل
تبعيات الإخراج.

-l ، --local-lib
يضبط المسار المتوافق المحلي :: lib لتثبيت الوحدات عليه. لست بحاجة إلى ضبط هذا
إذا قمت بالفعل بتكوين متغيرات بيئة shell باستخدام local :: lib ، لكن هذا
يمكن استخدامها لتجاوز ذلك أيضًا.

-L ، - المحلية-lib-الواردة
نفس الشيء مع "--local-lib" ولكن مع مجموعة مضمنة ذاتيًا. جميع التبعيات غير الأساسية سوف
حتى لو كانت مثبتة بالفعل.

على سبيل المثال،

cpanm -L extlib بلاك

سيثبت Plack وجميع تبعياته غير الأساسية في الدليل "extlib" ،
والتي يمكن تحميلها من تطبيقك بـ:

استخدم local :: lib '/ path / to / extlib' ؛

لاحظ أن هذا الخيار يعمل لا يعمل بشكل موثوق مع تركيبات perl الموردة من قبل
بائعي أنظمة التشغيل الذين ينزعون الوحدات القياسية من perl ، مثل RHEL و Fedora
و CentOS ، ما لم يمكنك أيضًا تثبيت الحزم التي توفر جميع الوحدات النمطية التي تم
جردت. بالنسبة لهذه الأنظمة ، قد ترغب في تثبيت التعريف "perl-core"
الحزمة التي تفعل ذلك بالضبط.

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

- استبعاد البائع
لا تقم بتضمين الوحدات المثبتة ضمن مسارات "البائع" عند البحث عن النواة
الوحدات النمطية عندما تكون العلامة "- المضمنة بذاتها" سارية المفعول. هذا يعيد السلوك
من قبل الإصدار 1.7023

--مرآة
يحدد عنوان URL الأساسي لمرآة CPAN المراد استخدامها ، مثل
"http://cpan.cpantesters.org/"(يمكنك حذف الشرطة المائلة اللاحقة). يمكنك تحديد
عدة عناوين URL متطابقة عن طريق تكرار خيار سطر الأوامر.

يمكنك استخدام دليل محلي يحتوي على بنية معكوسة لـ CPAN (تم إنشاؤها بواسطة أدوات مثل
كـ OrePAN أو Pinto) باستخدام نظام URL خاص "file: //". إذا بدأ عنوان URL المحدد
مع `/` (بدون أي مخطط) ، يعتبر بمثابة مخطط ملفات أيضًا.

cpanm - ملف المرآة: /// المسار / إلى / المرآة
cpanm - المرآة ~ / minicpan # لأن shell يتوسع ~ إلى / home / user

افتراضات على "http://www.cpan.org/".

- مرآة فقط
قم بتنزيل ملف فهرس المرآة 02packages.details.txt.gz بدلاً من الاستعلام عن ملف
CPAN Meta DB. سيؤدي هذا أيضًا إلى إلغاء الاشتراك بشكل فعال في إرسال إصدارات perl المحلية إلى
خوادم قاعدة البيانات الخلفية مثل CPAN Meta DB و MetaCPAN.

حدد هذا الخيار إذا كنت تستخدم مرآة محلية لـ CPAN ، مثل minicpan when
أنت غير متصل ، أو مؤشر CPAN الخاص بك (ويعرف أيضًا باسم darkpan).

--من ، -M
cpanm -M https://cpan.metacpan.org/
cpanm - من https://cpan.metacpan.org/

استخدم عنوان URL المتطابق المحدد وفهرسه كملف فقط مصدر للبحث والتنزيل
وحدات من.

يعمل بشكل مشابه لـ "-mirror" و "-mirror-only" مجتمعين ، مع اختلاف بسيط:
على عكس "المرآة" التي يلحق عنوان URL لقائمة المرايا ، "- من" (أو "-M" لـ
short) يستخدم عنوان URL المحدد على أنه فقط مصدر لتنزيل الفهرس والوحدات النمطية منه.
هذا يجعل الخيار دائمًا يتجاوز المرآة الافتراضية ، والتي ربما تم تعيينها
عبر الخيارات العامة مثل الخيار الذي تم تعيينه بواسطة متغير البيئة "PERL_CPANM_OPT".

تلميح: قد يكون من المفيد أن تسمي هذه الخيارات بأسماء شل المستعارة ، مثل:

الاسم المستعار minicpanm = 'cpanm - من ~ / minicpan'
الاسم المستعار darkpan = 'cpanm - من http://mycompany.example.com/DPAN'

- مؤشر المرآة
تجريبي: يحدد مسار الملف إلى "02packages.details.txt" للبحث عن وحدة
مؤشر.

--cpanmetadb
تجريبي: تحديد URI بديل لعمليات بحث فهرس CPAN MetaDB.

- ميتاكبان
يفضل MetaCPAN API على CPAN MetaDB.

--cpanfile
تجريبي: تحديد مسار بديل لملف cpanfile للبحث عنه ، ومتى
الأمر "--installdeps" قيد الاستخدام. افتراضات على "cpanfile".

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

الإعدادات الافتراضية على خطأ ، ويمكنك أن تقول "--لا يوجد موجه" للتجاوز إذا تم تعيينه في
الخيارات الافتراضية في "PERL_CPANM_OPT".

- ديف
تجريبي: ابحث عن إصدار أحدث للمطور أيضًا. افتراضات على خطأ.

- إعادة التثبيت
cpanm ، عند إعطاء اسم وحدة في سطر الأوامر (مثل "cpanm Plack") ، يتحقق من
الإصدار المثبت محليًا أولاً ويتخطى إذا كان مثبتًا بالفعل. هذا الخيار
يجعله يتخطى الشيك ، لذلك:

cpanm - إعادة تثبيت Plack

ستعيد تثبيت Plack حتى إذا كان الإصدار المثبت محليًا هو الأحدث أو الأحدث
(والذي سيحدث إذا قمت بتثبيت إصدار مطور من التحكم في الإصدار
مستودعات).

افتراضات على خطأ.

- تفاعلي
يجعل التكوين (مثل "Makefile.PL" و "Build.PL") تفاعليًا ، لذا يمكنك ذلك
أجب عن الأسئلة في التوزيع التي تتطلب تكوينًا مخصصًا أو مهمة ::
التوزيعات.

الإعدادات الافتراضية على false ، ويمكنك أن تقول "- no-Interactive" للتجاوز عندما يتم تعيينها في ملف
الخيارات الافتراضية في "PERL_CPANM_OPT".

--pp، --pureperl
تفضل إنشاء وحدات Pure perl من خلال تعيين "PUREPERL_ONLY = 1" لـ MakeMaker و
"--pureperl-only" للتوزيعات المستندة إلى Build.PL. لاحظ أنه ليس كل CPAN
وحدات تدعم هذه الاتفاقية حتى الآن.

- مع - توصي ، - مع - يقترح
تجريبي: تثبيت التبعيات المعلنة على أنها "توصي" و "تقترح"
على التوالي ، لكل مواصفات META. عندما يفشل تثبيت هذه التبعيات ، يستمر cpanm
التثبيت ، نظرًا لأنها مجرد توصية / اقتراح.

قد يؤدي تمكين هذا إلى إنشاء تبعية دائرية لعدد قليل من الوحدات النمطية على CPAN ،
عندما "توصي" تضيف وحدة "توصي" بإعادة الوحدة في المقابل.

هناك أيضًا "- بدون - موصى به" و "- بدون - يقترح" لتجاوز الإعداد الافتراضي
القرار الذي تم اتخاذه سابقًا في "PERL_CPANM_OPT".

الافتراضيات على خطأ لكليهما.

- مع التطور
تجريبي: التثبيتات تطوير تبعيات المرحلة في ملفات META أو "cpanfile" عندما
تستخدم مع "--installdeps". افتراضات على خطأ.

- مع ميزة ، - بدون ميزة ، - مع جميع الميزات
تجريبي: يحدد الميزة المطلوب تمكينها ، إذا كانت الوحدة النمطية تدعم الميزات الاختيارية
لكل META المواصفات 2.0.

cpanm --with-feature = opt_csv جدول البيانات :: قراءة

يمكن أيضًا اختيار الميزات بشكل تفاعلي عند تمكين الخيار "- التفاعلي".

يمكّن "- with-all-features" جميع الميزات الاختيارية ، ويمكن "- بدون ميزة" القيام بذلك
حدد ميزة لتعطيلها.

- تكوين مهلة ، - مهلة البناء ، - مهلة الاختبار
حدد مدة المهلة (بالثواني) لانتظار التكوين والبناء والاختبار
عملية. القيم الافتراضية الحالية هي: 60 للتكوين و 3600 للبناء و 1800 من أجل
الاختبار.

--configure-args، --build-args، --test-args، --install-args
تجريبي: تمرير الوسيطات لأوامر التكوين / البناء / الاختبار / التثبيت على التوالي ،
لوحدة معينة للتثبيت.

cpanm DBD :: mysql --configure-args = "- cflags = ... --libs = ..."

يتم تمكين الوسيطة فقط للوحدة النمطية التي تم تمريرها كوسيطة سطر أوامر ، وليس
التبعيات.

- scandeps
إهمال: يمسح تبعيات وحدات معينة ويخرج الشجرة في نص
شكل. (انظر "--format" أدناه لمزيد من الخيارات)

نظرًا لأن هذا الأمر لا يقوم بالفعل بتثبيت أي توزيعات ، فسيكون مفيدًا
هذا عن طريق كتابة:

cpanm - scandeps محفز :: وقت التشغيل

يمكنك التأكد من الوحدات النمطية التي سيتم تثبيتها.

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

--صيغة
إهمال: يحدد التنسيق الذي سيتم عرض شجرة التبعية الممسوحة ضوئيًا. متاح
الخيارات هي "شجرة" و "json" و "yaml" و "dists".

الشجرة تعرض الشجرة بتنسيق نص عادي. هذه هي القيمة الافتراضية.

json ، yaml
لإخراج الشجرة بتنسيق JSON أو YAML. يجب أن تكون وحدات JSON و YAML
مثبتة على التوالي. يتم تمثيل شجرة المخرجات على أنها مجموعة تكرارية
من:

[التوزيع ، التبعيات]

والحاوية عبارة عن مصفوفة تحتوي على عناصر الجذر. لاحظ أن هناك
قد تكون عدة عقد جذر ، حيث يمكنك إعطاء وحدات نمطية متعددة لملف
الأمر "--scandeps".

dists "dists" هو تنسيق إخراج خاص ، حيث يطبع اسم ملف التوزيع
في ال عمق أول طلب بعد حل التبعية ، مثل:

GAAS / MIME-Base64-3.13.tar.gz
GAAS / URI-1.58.tar.gz
PETDANCE / HTML-Tagset-3.20.tar.gz
GAAS / HTML-Parser-3.68.tar.gz
GAAS / libwww-perl-5.837.tar.gz

مما يعني أنه يمكنك تثبيت هذه التوزيعات بهذا الترتيب بدون إضافات
التبعيات. عند الدمج مع خيار "-L" ، سيكون من المفيد إعادة التشغيل
منشآت على أجهزة أخرى.

- حفظ التوزيعات
يحدد مسار الدليل الاختياري لنسخ كرات القطران التي تم تنزيلها في مرآة CPAN
متوافق مع بنية الدليل أي المؤلفون / معرف / A / AU / المؤلفون / Foo-Bar-version.tar.gz

إذا لم تأت كرة تار التوزيعة من CPAN ، على سبيل المثال من ملف محلي أو من
GitHub ، ثم سيتم حفظه تحت البائع / Foo-Bar-version.tar.gz.

- الظلال
يزيل ملفات الظل للتوزيع الذي تقوم بتثبيته. هذا
يزيل الالتباس إذا كنت تحاول تثبيت الوحدات الأساسية (الحياة المزدوجة) من
CPAN مقابل بيرل 5.10 أو أقدم ، أو الوحدات النمطية التي كانت تعتمد على XS ولكن تم التبديل إليها
نقي بيرل في بعض الإصدارات.

إذا قمت بتشغيل cpanm كجذر واستخدمت "INSTALL_BASE" أو ما يعادله لتحديد التخصيص
مسار التثبيت ، يجب عليك تعطيل هذا الخيار حتى لا تقوم بإلغاء التثبيت عن طريق الخطأ
تتضمن وحدات الحياة المزدوجة من القلب المسار.

الإعداد الافتراضي هو true إذا كان إصدار perl أصغر من 5.12 ، ويمكنك تعطيل ذلك
بظلال "- no-uninst-Shadows".

ملحوظة: منذ الإصدار 1.3000 ، تم إيقاف تشغيل هذه العلامة افتراضيًا لبيرل أحدث من
5.12 ، لأنه مع 5.12INC يحتوي على دليل site_perl قبل مكتبة بيرل الأساسية
المسار ، ولم يعد إلغاء تثبيت الظلال ضروريًا بعد الآن وسيؤدي إلى مزيد من الضرر عن طريق الحذف
الملفات من مسار المكتبة الأساسي.

- إلغاء التثبيت ، -U
يزيل وحدة من مسار المكتبة. يعثر على قائمة حزم لوحدات معينة ، و
يزيل جميع الملفات المضمنة في نفس التوزيع.

إذا قمت بتمكين local :: lib ، فإنه يزيل فقط الملفات من الدليل المحلي :: lib.

إذا حاولت إلغاء تثبيت وحدة في دليل "perl" (أي وحدة أساسية) ، فسيحدث خطأ
يتم رميها.

سيُطلب منك مربع حوار لتأكيد الملفات المراد حذفها. إذا قمت بتمرير الخيار "-f"
كذلك ، سيتم تخطي مربع الحوار وسيتم فرض إلغاء التثبيت.

- بحث كاسكاد
تجريبي: تحديد ما إذا كان سيتم البحث المتتالي عند تحديد عدة مرايا
ولا تحتوي المرآة على وحدة نمطية أو إصدار أقل من الوحدة النمطية منها
مطلوب. افتراضات على خطأ.

- تخطي مثبتة
يحدد ما إذا كان سيتم تخطي الوحدة النمطية الواردة في سطر الأوامر إذا كان أحدث إصدار لها
مثبت مسبقا. افتراضات على صواب.

ملحوظة: يجب تعيين متغير البيئة "PERL5LIB" بشكل صحيح حتى يعمل هذا
مع وحدات مثبتة باستخدام local :: lib ، ما لم تستخدم دائمًا الخيار "-l".

- تخطي راضية
تجريبي: يحدد ما إذا كانت الوحدة النمطية (والإصدار) المعطى في سطر الأوامر أم لا
تم تخطيه إذا كان مثبتًا بالفعل.

اذا ركضت:

cpanm - مستوفى للتخطي CGI DBI ~ 1.2

لن يقوم cpanm بتثبيتها إذا كان لديك بالفعل CGI (لأي إصدارات) أو لديك DBI
بإصدار أعلى من 1.2. إنه مشابه لـ "- skip-install" لكن أثناء
يتحقق "- skip-install" إذا كان الملف آخر تم تثبيت نسخة من CPAN ،
يتحقق "--skip-راضٍ" مما إذا كان الإصدار المطلوب (أم لا ، مما يعني أي إصدار)
تثبيت.

افتراضات على خطأ.

--تحقق
تحقق من سلامة ملفات التوزيع المستردة من PAUSE باستخدام CHECKSUMS و
التوقيعات (إن وجدت). افتراضات على خطأ.

- إصدار تقرير بيرل
ما إذا كان يُبلغ عن إصدار perl المثبت محليًا إلى خادم الويب المتنوع على أنه
جزء من وكيل المستخدم. الافتراضيات إلى true ما لم تكن متغيرات البيئة المرتبطة بـ CI مثل
تم تمكين "TRAVIS" أو "CI" أو "AUTOMATED_TESTING". يمكنك تعطيله باستخدام
"-لا-تقرير-بيرل-إصدار".

- التنظيف التلقائي
يحدد عدد الأيام التي تنتهي فيها صلاحية أدلة عمل cpanm. الافتراضي هو 7 ،
مما يعني أنه سيتم تنظيف أدلة العمل القديمة في غضون أسبوع واحد.

يمكنك تعيين القيمة إلى 0 لجعل cpan لا ينظف هذه الدلائل أبدًا.

- رجل صفحات
يولد صفحات الرجل للملفات التنفيذية (man1) والمكتبات (man3).

الافتراضيات إلى true (تم إنشاء صفحات man) ما لم يكن الخيار "-L | --local-lib-built" هو
يتم توفيره في هذه الحالة يتم تعيينه على خطأ. يمكنك تعطيله باستخدام "صفحات بلا رجل".

--lwp
يستخدم وحدة LWP لتنزيل الأشياء عبر HTTP. الافتراضات إلى true ، ويمكنك القول
"--no-lwp" لتعطيل استخدام LWP ، عندما تريد ترقية LWP من CPAN على بعض المعطلات
أنظمة بيرل.

--جيت
يستخدم GNU Wget (إن وجد) لتنزيل الأشياء. الافتراضات إلى true ، ويمكنك القول
"--no-wget" لتعطيل استخدام Wget (إصدارات Wget الأقدم من 1.9 لا تدعم
"--retry-connrefused" الخيار الذي تستخدمه cpanm).

--لفة
يستخدم cURL (إن وجد) لتنزيل الأشياء. الافتراضات إلى true ، ويمكنك القول
"- no-curl" للتعطيل باستخدام cURL.

عادةً مع تعيين خيارات "--lwp" و "--wget" و "--curl" على true (وهي
افتراضي) cpanm يحاول LWP و Wget و cURL و HTTP :: Tiny (بهذا الترتيب) ويستخدم أول
واحد متاح.

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