cpanmp - آنلاین در ابر

برنامه:

نام

cpanm - ماژول ها را از CPAN بسازید و نصب کنید

خلاصه

cpanm تست::بیشتر # install Test::بیشتر
cpanm MIYAGAWA/Plack-0.99_05.tar.gz # مسیر توزیع کامل
cpanm http://example.org/LDS/CGI.pm-3.20.tar.gz # نصب از URL
cpanm ~/dists/MyCompany-Enterprise-1.00.tar.gz # از یک فایل محلی نصب کنید
cpanm --interactive Task::Kensho # به صورت تعاملی پیکربندی کنید
cpanm . # از دایرکتوری محلی نصب کنید
cpanm --installdeps. # همه ی دپ ها را برای دایرکتوری فعلی نصب کنید
cpanm -L extlib Plack # Plack و تمام عمق‌های غیر هسته‌ای را در extlib نصب کنید
cpanm --mirror http://cpan.cpantesters.org/ DBI # از آینه همگام سازی سریع استفاده می کند
cpanm --from https://cpan.metacpan.org/ Plack # فقط از آینه HTTPS استفاده کنید

دستورات

(استدلال)
آرگومان های خط فرمان می توانند نام ماژول، فایل توزیع، فایل محلی باشند
مسیر، URL HTTP یا URL مخزن git. دستورات زیر همگی همانطور که انتظار دارید کار خواهند کرد.

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

علاوه بر این، می توانید از نماد با استفاده از "~" و "@" برای تعیین نسخه برای a استفاده کنید
ماژول داده شده "~" نیاز نسخه را در قالب CPAN::Meta::Spec مشخص می کند،
در حالی که "@" نسخه دقیق را پین می کند و یک میانبر برای "~"== VERSION" است.

cpanm Plack~1.0000 # 1.0000 یا بالاتر
cpanm Plack~">= 1.0000، < 2.0000" # آخرین نسخه 1.xxxx
cpanm [ایمیل محافظت شده] # نسخه خاص. همانند Plack~"== 0.9990"

درخواست نسخه شامل نسخه یا محدوده خاص به MetaCPAN ارسال می شود
جستجوی نسخه های قبلی پرس و جو به طور پیش فرض بایگانی های BackPAN را جستجو می کند.
مگر اینکه گزینه "--dev" را مشخص کنید که در این صورت نسخه های آرشیو شده فیلتر می شوند
از.

برای یک مخزن git، می توانید یک شاخه، تگ یا commit SHA را برای ساخت مشخص کنید. در
پیش فرض "استاد" است

cpanm git://github.com/plack/[ایمیل محافظت شده] # برچسب
cpanm git://github.com/plack/Plack.git@devel # شعبه

-i، --نصب کنید
ماژول ها را نصب می کند. این یک رفتار پیش فرض است و این فقط یک سازگاری است
گزینه ای برای اینکه آن را مانند cpan یا cpanp کار کند.

-- ارتقاء خود
خود را ارتقا می دهد. این فقط یک نام مستعار برای:

برنامه cpanm::cpanminus

-- اطلاعات
اطلاعات توزیع را در قالب "AUTHOR/Dist-Name-ver.tar.gz" در قالب نمایش می دهد.
استاندارد خارج شده است.

--deps را نصب کنید
وابستگی های توزیع هدف را نصب می کند اما خودش را نمی سازد. مفید اگر
می خواهید برنامه را از یک مخزن کنترل شده نسخه مانند git امتحان کنید.

cpanm --installdeps.

--نگاه کن
توزیع را دانلود و باز کنید و سپس دایرکتوری را با پوسته خود باز کنید.
برای بررسی کد منبع یا انجام آزمایش دستی مفید است.

-h، --کمک
پیام راهنما را نمایش می دهد.

-V ، - برگرداندن
شماره نسخه را نمایش می دهد.

OPTIONS

می‌توانید گزینه‌های پیش‌فرض را در متغیر محیطی «PERL_CPANM_OPT» مشخص کنید.

-f، -- نیرو
نصب اجباری ماژول ها حتی زمانی که تست انجام نشد.

-n، --notest
از تست ماژول ها صرف نظر کنید. از این فقط زمانی استفاده کنید که فقط می خواهید در وقت خود صرفه جویی کنید
نصب صدها توزیع برای همان پرل و معماری که قبلاً داشتید
تست شده تا مطمئن شوید که درست می شود.

پیش‌فرض روی false قرار می‌گیرد، و می‌توانید برای لغو زمانی که در قسمت تنظیم شده است، بگویید «--no-notest»
گزینه های پیش فرض در "PERL_CPANM_OPT".

--فقط تست
فقط تست ها را اجرا کنید و ماژول یا توزیع های مشخص شده را نصب نکنید. مفید اگر
می‌خواهید تأیید کنید که نسخه‌های جدید (یا حتی قدیمی) تست‌های واحد خود را بدون پشت سر گذاشتن گذرانده‌اند
نصب ماژول

توجه داشته باشید که اگر این گزینه را با ماژول یا توزیعی که دارد مشخص کنید
وابستگی ها، این وابستگی ها نصب می شوند اگر در حال حاضر آنها را نداشته باشید.

-S، --سودو
هنگام نصب ماژول ها با "sudo" به کاربر root بروید. اگر می خواهید از این استفاده کنید
نصب ماژول ها به سیستم پرل شامل مسیر است.

پیش‌فرض‌ها روی false قرار می‌گیرند، و می‌توانید زمانی که در قسمت تنظیم شده است، برای لغو کردن «--no-sudo» بگویید
گزینه های پیش فرض در "PERL_CPANM_OPT".

-v، -- پرحرف
خروجی را پرمخاطب می کند. همچنین پیکربندی تعاملی را فعال می کند. (دیدن
--در ارتباط بودن)

-q، --آرام
خروجی را حتی بی صداتر از پیش فرض می کند. این فقط موفقیت / شکست خورده را نشان می دهد
وابستگی به خروجی

-l، --local-lib
مسیر سازگار local::lib را برای نصب ماژول ها تنظیم می کند. شما نیازی به تنظیم این ندارید
اگر قبلاً متغیرهای محیط پوسته را با استفاده از local::lib پیکربندی کرده اید، اما این
می توان برای نادیده گرفتن آن نیز استفاده کرد.

-L، --local-lib-contained
با "--local-lib" یکسان است، اما با - مجموعه خودکفایی. همه وابستگی های غیر اصلی این کار را خواهند کرد
حتی اگر قبلاً نصب شده باشند نصب شوند.

به عنوان مثال،

cpanm -L extlib Plack

Plack و تمام وابستگی های غیر اصلی آن را در دایرکتوری "extlib" نصب می کند.
که می تواند از برنامه شما بارگیری شود با:

استفاده از local::lib '/path/to/extlib';

توجه داشته باشید که این گزینه انجام می دهد نه به طور قابل اعتماد با تاسیسات پرل ارائه شده توسط
فروشندگان سیستم عامل که ماژول های استاندارد را از perl جدا می کنند، مانند RHEL، Fedora
و CentOS، مگر اینکه شما همچنین بسته هایی را نصب می کنید که تمام ماژول های موجود را تامین می کند
برهنه شده برای این سیستم ها احتمالاً می خواهید متا "perl-core" را نصب کنید.
بسته ای که دقیقاً این کار را انجام می دهد.

-- خودکفا
هنگام بررسی وابستگی ها، فرض کنید هیچ ماژول غیر هسته ای روی آن نصب نشده است
سیستم. اگر می‌خواهید وابستگی‌های برنامه را در یک دایرکتوری دسته‌بندی کنید، مفید است
می تواند به ماشین های دیگر توزیع شود.

--حذف-فروشنده
هنگام جستجوی هسته، ماژول‌های نصب شده در مسیرهای «فروشنده» را درج نکنید
زمانی که پرچم "--self-contained" در حال اجرا باشد، ماژول ها را تشکیل می دهند. این رفتار را بازیابی می کند
از قبل از نسخه 1.7023

--آینه
نشانی وب پایه را برای آینه CPAN مشخص می کند، مانند
"http://cpan.cpantesters.org/" (می توانید اسلش انتهایی را حذف کنید). می توانید مشخص کنید
چندین آدرس آینه ای با تکرار گزینه خط فرمان.

می توانید از دایرکتوری محلی استفاده کنید که ساختار آینه ای CPAN دارد (ایجاد شده توسط ابزارهایی مانند
به عنوان OrePAN یا Pinto) با استفاده از یک طرح URL ویژه "file://". اگر URL داده شده شروع شود
با `/` (بدون هیچ طرحی)، به عنوان یک طرح فایل نیز در نظر گرفته می شود.

cpanm --mirror file:///path/to/mirror
cpanm --mirror ~/ مینی تابه # زیرا پوسته ~ به /home/user گسترش می یابد

پیش فرض های "http://www.cpan.org/".

--فقط آینه
فایل نمایه 02packages.details.txt.gz mirror را به جای پرس و جو دانلود کنید
CPAN Meta DB. این همچنین به طور مؤثری از ارسال نسخه‌های محلی پرل شما به این آدرس منصرف می‌شود
سرورهای پایگاه داده باطن مانند 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" ترکیبی عمل می کند، با یک تفاوت کوچک:
بر خلاف "--mirror" که ضمیمه می کند URL به لیست آینه ها، "--from" (یا "-M" برای
short) از URL مشخص شده به عنوان خود استفاده می کند فقط منبعی برای دانلود فهرست و ماژول ها از.
این باعث می شود که این گزینه همیشه آینه پیش فرض را که ممکن است تنظیم شده باشد لغو کند
از طریق گزینه های سراسری مانند گزینه ای که توسط متغیر محیطی "PERL_CPANM_OPT" تنظیم شده است.

نکته: ممکن است مفید باشد اگر این گزینه ها را با نام مستعار پوسته خود نامگذاری کنید، مانند:

مستعار minicpanm='cpanm --from ~/ مینی تابه'
مستعار darkpan='cpanm --from http://mycompany.example.com/DPAN'

-- آینه-شاخص
تجربی: مسیر فایل "02packages.details.txt" را برای جستجوی ماژول مشخص می کند
شاخص.

--cpanmetadb
تجربی: یک URI جایگزین برای جستجوهای فهرست CPAN MetaDB مشخص می کند.

-- متاکپان
MetaCPAN API را به CPAN MetaDB ترجیح می دهد.

--cpanfile
تجربی: یک مسیر جایگزین برای cpanfile برای جستجو، زمانی که
دستور "--installdeps" در حال استفاده است. پیش‌فرض «cpanfile» است.

--سریع
هنگامی که یک آزمایش با شکست مواجه می شود، درخواست می کند تا بتوانید رد شوید، نصب را مجبور کنید، دوباره امتحان کنید یا در آن جستجو کنید
پوسته تا ببینیم چه مشکلی دارد. همچنین زمانی که یکی از وابستگی ها شکست خورد اگر
می خواهید نصب را ادامه دهید.

پیش‌فرض روی false است، و می‌توانید بگویید «--no-prompt» برای لغو اگر در
گزینه های پیش فرض در "PERL_CPANM_OPT".

--dev
تجربی: نسخه توسعه دهنده جدیدتری را نیز جستجو کنید. پیش فرض به نادرست.

-- دوباره نصب کنید
cpanm، هنگامی که نام ماژول در خط فرمان داده می شود (یعنی "cpanm Plack")، آن را بررسی می کند
ابتدا نسخه محلی نصب شده است و اگر قبلاً نصب شده باشد از آن می گذرد. این گزینه
باعث می شود آن را از چک رد کند، بنابراین:

cpanm -- دوباره Plack را نصب کنید

حتی اگر نسخه محلی نصب شده شما جدیدترین یا حتی جدیدتر باشد، Plack را دوباره نصب می کند
(این اتفاق می افتد اگر نسخه توسعه دهنده را از کنترل نسخه نصب کنید
مخازن).

پیش فرض به نادرست.

--در ارتباط بودن
پیکربندی (مانند "Makefile.PL" و "Build.PL") را تعاملی می کند، بنابراین شما می توانید
به سوالاتی که در توزیع نیاز به پیکربندی سفارشی یا Task دارند پاسخ دهید::
توزیع ها

پیش‌فرض‌ها روی false است، و می‌توانید بگویید «--no-interactive» تا زمانی که در
گزینه های پیش فرض در "PERL_CPANM_OPT".

--pp، --pureperl
با تنظیم "PUREPERL_ONLY=1" برای MakeMaker و
"--pureperl-only" برای توزیع های مبتنی بر Build.PL. توجه داشته باشید که نه همه CPAN
ماژول ها هنوز از این کنوانسیون پشتیبانی می کنند.

--با-توصیه می کند، --با-پیشنهاد می کند
تجربی: وابستگی های اعلام شده به عنوان "توصیه می کند" و "پیشنهاد" را نصب می کند
به ترتیب، بر اساس مشخصات META. وقتی این وابستگی ها نصب نشدند، cpanm ادامه می یابد
نصب، زیرا آنها فقط توصیه/پیشنهاد هستند.

فعال کردن این به طور بالقوه می تواند یک وابستگی دایره ای برای چند ماژول در CPAN ایجاد کند.
when "recommends" ماژولی را اضافه می کند که در ازای آن ماژول را "پیشنهاد" می کند.

همچنین "--بدون-توصیه" و "--بدون-پیشنهاد" برای لغو پیش فرض وجود دارد
تصمیم قبلاً در "PERL_CPANM_OPT" گرفته شده است.

پیش فرض به false برای هر دو.

--با-توسعه
تجربی: زمانی که وابستگی های فازی را در فایل های META یا "cpanfile" نصب می کند
با "--installdeps" استفاده می شود. پیش فرض به نادرست.

--با ویژگی، --بدون ویژگی، --با همه ویژگی ها
تجربی: مشخص می کند که اگر یک ماژول از ویژگی های اختیاری پشتیبانی می کند، فعال شود
در META spec 2.0.

cpanm --with-feature=opt_csv صفحه گسترده::خواندن

هنگامی که گزینه "--تعاملی" فعال است، می توان ویژگی ها را به صورت تعاملی انتخاب کرد.

"--with-all-features" همه ویژگی های اختیاری را فعال می کند و "--without-feature" می تواند
یک ویژگی را برای غیرفعال کردن انتخاب کنید.

--configure-timeout، --build-timeout، --test-timeout
مدت زمان توقف (بر حسب ثانیه) را برای منتظر ماندن برای پیکربندی، ساخت و آزمایش مشخص کنید
روند. مقادیر پیش فرض فعلی عبارتند از: 60 برای پیکربندی، 3600 برای ساخت و 1800 برای
آزمون.

--configure-args، --build-args، --test-args، --install-args
تجربی: به ترتیب برای دستورات پیکربندی/ساخت/تست/نصب آرگومان ها را ارسال کنید،
برای نصب یک ماژول مشخص

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

آرگومان فقط برای ماژول ارسال شده به عنوان آرگومان خط فرمان فعال است، نه
وابستگی ها

--اسکندپس
منسوخ: وابستگی های ماژول های داده شده را اسکن می کند و درخت را در یک متن خروجی می دهد
قالب (برای گزینه های بیشتر به "--format" در زیر مراجعه کنید)

از آنجا که این دستور در واقع هیچ توزیعی را نصب نمی کند، مفید خواهد بود
که با تایپ کردن:

cpanm --scandeps Catalyst::Runtime

می توانید مطمئن شوید که چه ماژول هایی نصب خواهند شد.

این دستور ماژول هایی را که قبلاً در خود نصب کرده اید در نظر می گیرد
سیستم. اگر می خواهید ببینید چه ماژول هایی در برابر پرل وانیلی نصب خواهند شد
نصب، ممکن است بخواهید آن را با گزینه "-L" ترکیب کنید.

--قالب
منسوخ: تعیین می کند که درخت وابستگی اسکن شده با چه قالبی نمایش داده شود. در دسترس
گزینه های "درخت"، "json"، "yaml" و "dists" هستند.

درخت درخت را در قالب متن ساده نمایش می دهد. این مقدار پیش فرض است.

json، یامل
درخت را در قالب 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" ترکیب می شود، پخش مجدد آن مفید خواهد بود
نصب بر روی ماشین های دیگر

--save-dists
مسیر دایرکتوری اختیاری را برای کپی کردن تاربال های دانلود شده در آینه CPAN مشخص می کند
ساختار دایرکتوری سازگار به عنوان مثال authors/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

اگر توزیع تاربال از CPAN نیامده باشد، برای مثال از یک فایل محلی یا از
GitHub، سپس در زیر ذخیره می شود vendor/Foo-Bar-version.tar.gz.

-- uninst-shadows
فایل های سایه توزیعی را که در حال نصب هستید حذف نصب می کند. این
اگر می‌خواهید ماژول‌های اصلی (دو عمر) را از آن نصب کنید، سردرگمی را از بین می‌برد
CPAN در برابر perl 5.10 یا قدیمی تر، یا ماژول هایی که قبلا مبتنی بر XS بودند اما به
پرل خالص در برخی از نسخه ها.

اگر cpanm را به‌عنوان روت اجرا می‌کنید و از «INSTALL_BASE» یا معادل آن برای تعیین سفارشی استفاده می‌کنید.
مسیر نصب، شما باید این گزینه را غیرفعال کنید تا به طور تصادفی حذف نشوید
ماژول های دو عمر از هسته شامل مسیر هستند.

اگر نسخه پرل شما کوچکتر از 5.12 باشد، پیش فرض درست است، و می توانید آن را غیرفعال کنید
با "--no-uninst-shadows".

توجه داشته باشید: از نسخه 1.3000 این پرچم به طور پیش فرض برای پرل جدیدتر خاموش است
5.12، زیرا با 5.12 @INC شامل پوشه site_perl است قبل از کتابخانه هسته پرل
مسیر، و حذف سایه ها دیگر ضروری نیست و با حذف آسیب بیشتری می زند
فایل ها از مسیر کتابخانه هسته.

- حذف نصب، -U
یک ماژول را از مسیر کتابخانه حذف نصب می کند. یک لیست بسته برای ماژول های داده شده پیدا می کند و
تمام فایل های موجود در همان توزیع را حذف می کند.

اگر local::lib را فعال کنید، فقط فایل ها را از پوشه local::lib حذف می کند.

اگر سعی کنید یک ماژول را در پوشه "perl" (یعنی ماژول اصلی) حذف نصب کنید، یک خطا رخ می دهد
پرتاب شود.

یک دیالوگ برای تایید فایل هایی که قرار است حذف شوند، نمایش داده می شود. اگر گزینه "-f" را پاس کنید
همچنین، گفتگو رد می شود و حذف نصب اجباری می شود.

--آبشار-جستجو
تجربی: تعیین می کند که آیا هنگام تعیین چند آینه، جستجوی آبشاری انجام شود یا خیر
و یک آینه ماژول ندارد یا نسخه پایین تری از ماژول دارد
درخواست کرد. پیش فرض به نادرست.

-- skip-installed
مشخص می کند که آیا ماژول ارائه شده در خط فرمان در صورت آخرین نسخه آن نادیده گرفته می شود یا خیر
قبلا نصب شده است پیش فرض ها به درست است.

توجه داشته باشید: متغیر محیطی "PERL5LIB" باید به درستی تنظیم شود تا کار کند
با ماژول های نصب شده با استفاده از local::lib، مگر اینکه همیشه از گزینه "-l" استفاده کنید.

-- پرش - راضی
تجربی: مشخص می کند که آیا یک ماژول (و نسخه) داده شده در خط فرمان وجود دارد یا خیر
اگر قبلاً نصب شده باشد، رد شده است.

اگر بدوید:

cpanm --Skip-satisfied CGI DBI~1.2

اگر قبلاً CGI (برای هر نسخه‌ای) دارید یا DBI دارید، cpanm آنها را نصب نمی‌کند
با نسخه بالاتر از 1.2. این شبیه به "--skip-installed" است اما در حالی که
"--skip-installed" بررسی می کند که آیا آخرین نسخه CPAN نصب شده است،
"--skip-satisfied" بررسی می کند که آیا نسخه درخواستی (یا نه، یعنی هر نسخه ای)
نصب شده است.

پیش فرض به نادرست.

-- تأیید کنید
یکپارچگی فایل های توزیع بازیابی شده از PAUSE را با استفاده از CHECKSUMS و
امضاها (در صورت یافتن). پیش فرض به نادرست.

--report-perl-version
این که آیا نسخه perl نصب شده محلی را به سرورهای مختلف وب به عنوان گزارش می دهد
بخشی از User-Agent. پیش‌فرض به درستی می‌رسد مگر اینکه متغیرهای محیطی مرتبط با CI مانند
«TRAVIS»، «CI» یا «AUTOMATED_TESTING» فعال است. با استفاده از آن می توانید آن را غیرفعال کنید
"--no-report-perl-version".

-- پاکسازی خودکار
تعداد روزهایی را که فهرست‌های کاری cpanm منقضی می‌شوند را مشخص می‌کند. به طور پیش فرض 7،
یعنی دایرکتوری های قدیمی کار در یک هفته پاک می شوند.

می توانید مقدار را روی 0 تنظیم کنید تا cpan هرگز آن دایرکتوری ها را پاک نکند.

--صفحه های انسانی
صفحات man را برای فایل های اجرایی (man1) و کتابخانه ها (man3) ایجاد می کند.

پیش‌فرض‌ها به true (صفحات man ایجاد شده‌اند) مگر اینکه گزینه "-L|--local-lib-contained" باشد
ارائه شده که در این صورت روی false تنظیم می شود. می توانید آن را با "--no-man-pages" غیرفعال کنید.

--lwp
از ماژول LWP برای بارگیری موارد از طریق HTTP استفاده می کند. پیش فرض ها به درست است، و شما می توانید بگویید
"--no-lwp" برای غیرفعال کردن با استفاده از LWP، زمانی که می خواهید LWP را از CPAN در برخی از موارد خراب ارتقا دهید.
سیستم های پرل

--wget
از GNU Wget (در صورت موجود بودن) برای دانلود مطالب استفاده می کند. پیش فرض ها به درست است، و شما می توانید بگویید
"--no-wget" برای غیرفعال کردن با استفاده از Wget (نسخه‌های Wget قدیمی‌تر از 1.9 از
گزینه "--retry-connrefused" استفاده شده توسط cpanm).

--حلقه
از cURL (در صورت موجود بودن) برای بارگیری موارد استفاده می کند. پیش فرض ها به درست است، و شما می توانید بگویید
"--no-curl" برای غیرفعال کردن با استفاده از cURL.

به طور معمول با گزینه های "--lwp"، "--wget" و "--curl" روی true تنظیم می شوند (که
پیش فرض) cpanm LWP، Wget، cURL و HTTP::Tiny (به ترتیب) را امتحان می کند و از اولین
یکی موجود

با استفاده از خدمات onworks.net از cpanmp آنلاین استفاده کنید