cpanmp - מקוון בענן

תָכְנִית:

שֵׁם

cpanm - קבל, פתח מהאריזה לבנות והתקן מודולים מ-CPAN

תַקצִיר

cpanm Test::More # install Test::More
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. # התקן את כל ה-deps עבור הספרייה הנוכחית
cpanm -L extlib Plack # התקן את Plack ואת כל ה-Deps שאינם הליבה ב-extlib
cpanm --mirror http://cpan.cpantesters.org/ DBI # השתמש במראה המסנכרן המהיר
cpanm --from https://cpan.metacpan.org/ Plack # השתמש רק במראה HTTPS

פקודות

(טיעונים)
ארגומנטים של שורת הפקודה יכולים להיות שם מודול, קובץ הפצה, קובץ מקומי
נתיב, כתובת URL של HTTP או כתובת אתר של מאגר 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, --install
מתקין את המודולים. זוהי התנהגות ברירת מחדל וזו רק תאימות
אפשרות לגרום לזה לעבוד כמו cpan או cpanp.

--שדרוג עצמי
משדרג את עצמו. זה רק כינוי עבור:

אפליקציית cpanm::cpanminus

- מידע
מציג את מידע ההפצה בפורמט "AUTHOR/Dist-Name-ver.tar.gz" ב-
סטנדרטי החוצה.

--התקן את ההגדרות
מתקין את התלות של הפצת היעד אך לא בונה את עצמו. שימושי אם
אתה רוצה לנסות את היישום ממאגר מבוקר גרסה כגון git.

cpanm --installdeps.

--תראה
הורד ופרק את ההפצה ולאחר מכן פתח את הספרייה עם המעטפת שלך.
שימושי לחטט בקוד המקור או לבצע בדיקות ידניות.

-ח, --עזרה
מציג את הודעת העזרה.

-V, - גרסה
מציג את מספר הגרסה.

אפשרויות

אתה יכול לציין את אפשרויות ברירת המחדל במשתנה הסביבה "PERL_CPANM_OPT".

-f, --כוח
כפוי התקנה של מודולים גם כאשר הבדיקה נכשלה.

-n, --הערה
דלג על בדיקת המודולים. השתמש בזה רק כאשר אתה רק רוצה לחסוך זמן עבור
התקנת מאות הפצות לאותה perl וארכיטקטורה שכבר התקנת
נבדק כדי לוודא שהוא בונה תקין.

ברירת המחדל היא false, ואתה יכול לומר "--no-notest" כדי לעקוף כאשר הוא מוגדר ב-
אפשרויות ברירת המחדל ב-"PERL_CPANM_OPT".

--לבדיקה בלבד
הפעל את הבדיקות בלבד, ואל תתקין את המודול או ההפצות שצוינו. שימושי אם
אתה רוצה לוודא שהמהדורות החדשות (או אפילו הישנות) עוברות את בדיקות היחידה שלה בלי
התקנת המודול.

שים לב שאם אתה מציין אפשרות זו עם מודול או הפצה שיש
תלות, תלויות אלה יותקנו אם אין לך אותן כרגע.

-S, --סודו
עבור למשתמש השורש עם "sudo" בעת התקנת מודולים. השתמש בזה אם אתה רוצה
להתקין מודולים למערכת perl include path.

ברירת המחדל היא false, ואתה יכול לומר "--no-sudo" כדי לעקוף כאשר הוא מוגדר ב-
אפשרויות ברירת המחדל ב-"PERL_CPANM_OPT".

-v, --מלל
הופך את הפלט למילולי. זה גם מאפשר את התצורה האינטראקטיבית. (לִרְאוֹת
--אינטראקטיבי)

-ש, -שקט
הופך את הפלט לשקט אפילו יותר מאשר ברירת המחדל. זה מראה רק את המוצלח/נכשל
תלות בפלט.

-l, --local-lib
מגדיר את הנתיב התואם המקומי::lib להתקנת מודולים. אתה לא צריך להגדיר את זה
אם כבר תגדיר את משתני סביבת המעטפת באמצעות local::lib, אבל זה
יכול לשמש גם כדי לעקוף את זה.

-L, --local-lib-contained
אותו דבר עם "--local-lib" אבל עם --סט עצמאי. כל התלות שאינה הליבה תהיה
להיות מותקנים גם אם הם כבר מותקנים.

לדוגמה,

cpanm -L extlib Plack

יתקין את Plack ואת כל התלות שאינה הליבה שלו בספרייה "extlib",
אשר ניתן לטעון מהאפליקציה שלך עם:

השתמש ב-local::lib '/path/to/extlib';

שימו לב שאופציה זו כן לא עבודה מהימנה עם התקנות perl שסופקו על ידי
ספקי מערכות הפעלה שמסירים מודולים סטנדרטיים מ-perl, כגון RHEL, Fedora
ו-CentOS, אֶלָא אִם אתה גם מתקין חבילות המספקות את כל המודולים שהיו
חָשׂוּף. עבור מערכות אלו סביר להניח שתרצה להתקין את המטא- "perl-core"
חבילה שעושה בדיוק את זה.

--מסוגל
כאשר בוחנים את התלות, נניח שלא מותקנים מודולים שאינם הליבה ב-
מערכת. שימושי אם אתה רוצה לאגד תלות של יישומים בספרייה אחת כך שאתה
יכול להפיץ למכונות אחרות.

--exclude-ספק
אל תכלול מודולים המותקנים בנתיבי 'ספק' בעת חיפוש הליבה
מודולים כאשר הדגל "--עצמאי" בתוקף. זה משחזר את ההתנהגות
מלפני גרסה 1.7023

--מַרְאָה
מציין את כתובת ה-URL הבסיסית לשימוש במראה ה-CPAN, כגון
"http://cpan.cpantesters.org/" (אתה יכול להשמיט את הלוכסן האחורי). אתה יכול לציין
כתובות אתרים מרובות על ידי חזרה על אפשרות שורת הפקודה.

אתה יכול להשתמש בספרייה מקומית שיש לה מבנה מראה CPAN (שנוצר על ידי כלים כגון
כמו OrePAN או Pinto) באמצעות סכימת URL מיוחדת "file://". אם כתובת האתר הנתונה מתחילה
עם `/` (ללא סכמה כלשהי), זה נחשב גם כסכימת קבצים.

cpanm --mirror file:///path/to/mirror
cpanm --mirror ~/minicpan # כי מעטפת מתרחבת ~ ל- /home/user

ברירת המחדל היא "http://www.cpan.org/".

--מראה בלבד
הורד את קובץ האינדקס 02packages.details.txt.gz של המראה במקום לבצע שאילתה
CPAN Meta DB. זה גם יבטל למעשה את שליחת גרסאות ה-perl המקומיות שלך
שרתי מסד נתונים עורפיים כגון CPAN Meta DB ו- MetaCPAN.

בחר באפשרות זו אם אתה משתמש במראה מקומית של CPAN, כגון minicpan when
אתה לא מקוון, או אינדקס CPAN משלך (המכונה darkpan).

--מ, -מ
cpanm -M https://cpan.metacpan.org/
cpanm --מאת https://cpan.metacpan.org/

השתמש בכתובת המראה הנתונה ובאינדקס שלה בתור רק מקור לחיפוש ולהורדה
מודולים מ.

זה עובד בדומה ל-"--mirror" ו-"--mirror-only" בשילוב, עם הבדל קטן:
שלא כמו "--mirror" אשר מוסיף כתובת האתר לרשימת המראות, "--from" (או "-M" עבור
קצר) משתמש בכתובת ה-URL שצוינה בתור שלה רק מקור להורדת אינדקס ומודולים.
זה גורם לאפשרות לעקוף תמיד את מראה ברירת המחדל, שאולי הוגדרה
באמצעות אפשרויות גלובליות כמו זו שנקבעה על ידי משתנה הסביבה "PERL_CPANM_OPT".

טיפ: זה עשוי להיות שימושי אם תן שם לאפשרויות אלה עם כינויי המעטפת שלך, כמו:

כינוי minicpanm='cpanm --from ~/minicpan'
כינוי darkpan='cpanm --from http://mycompany.example.com/DPAN'

--אינדקס מראה
ניסיוני: מציין את נתיב הקובץ אל "02packages.details.txt" לחיפוש מודול
אינדקס.

--cpanmetadb
ניסיוני: מציין URI חלופי עבור חיפושי אינדקס CPAN MetaDB.

--metacpan
מעדיף את MetaCPAN API על פני CPAN MetaDB.

--cpanfile
ניסיוני: ציין נתיב חלופי עבור cpanfile לחיפוש, מתי
הפקודה "--installdeps" נמצאת בשימוש. ברירת המחדל היא "cpanfile".

--מיידי
הודעה כאשר בדיקה נכשלת כך שתוכל לדלג, לאלץ התקנה, לנסות שוב או להסתכל ב-
פגז כדי לראות מה לא בסדר. זה גם מנחה כאשר אחד התלות נכשל אם
אתה רוצה להמשיך בהתקנה.

ברירת המחדל היא false, ואתה יכול לומר "--no-prompt" כדי לעקוף אם זה מוגדר ב-
אפשרויות ברירת המחדל ב-"PERL_CPANM_OPT".

--dev
ניסיוני: חפש גם מהדורת מפתחים חדשה יותר. ברירת המחדל ל-false.

--התקן מחדש
cpanm, כאשר ניתן שם מודול בשורת הפקודה (כלומר "cpanm Plack"), בודק את
גרסה מותקנת מקומית תחילה ומדלג אם היא כבר מותקנת. אפשרות זו
גורם לזה לדלג על ההמחאה, אז:

cpanm --התקן מחדש את Plack

יתקין מחדש את Plack גם אם הגרסה המותקנת המקומית שלך היא העדכנית ביותר, או אפילו חדשה יותר
(מה שיקרה אם תתקין מהדורת מפתחים מבקרת גרסאות
מאגרים).

ברירת המחדל ל-false.

--אינטראקטיבי
הופך את התצורה (כגון "Makefile.PL" ו-"Build.PL") לאינטראקטיבית, כך שתוכל
ענה על שאלות בהפצה הדורשת תצורה מותאמת אישית או משימה::
הפצות.

ברירת המחדל היא false, ואתה יכול לומר "--no-interactive" כדי לעקוף כאשר זה מוגדר ב-
אפשרויות ברירת המחדל ב-"PERL_CPANM_OPT".

--pp, --pureperl
העדיפו בניין Perl Pure של מודולים על ידי הגדרת "PUREPERL_ONLY=1" עבור MakeMaker ו-
"--pureperl-only" עבור הפצות מבוססות Build.PL. שים לב שלא כל ה-CPAN
מודולים תומכים במוסכמה זו עדיין.

--עם-ממליץ, --עם-מציע
ניסיוני: התקנות תלות שהוכרזו כ"ממליץ" ו"מציע"
בהתאמה, לפי מפרט META. כאשר התלות הללו לא מצליחות להתקין, cpanm ממשיך
ההתקנה, מכיוון שהם רק המלצה/הצעה.

הפעלת זה עשויה ליצור תלות מעגלית עבור כמה מודולים ב-CPAN,
כאשר "ממליץ" מוסיף מודול ש"ממליץ" בחזרה על המודול בתמורה.

יש גם "--ללא-מליץ" ו-"--ללא-הצעות" כדי לעקוף את ברירת המחדל
החלטה שהתקבלה קודם לכן ב-"PERL_CPANM_OPT".

ברירת המחדל ל-false עבור שניהם.

--עם-לפתח
ניסיוני: התקנות מפתחות תלות שלב בקבצי META או "cpanfile" כאשר
בשימוש עם "--installdeps". ברירת המחדל ל-false.

--עם-תכונה, --ללא-תכונה, --עם-כל-התכונות
ניסיוני: מציין את התכונה שיש להפעיל, אם מודול תומך בתכונות אופציונליות
לפי מפרט META 2.0.

cpanm --with-feature=opt_csv גיליון אלקטרוני::Read

ניתן גם לבחור את התכונות באופן אינטראקטיבי כאשר האפשרות "--אינטראקטיבית" מופעלת.

"--with-all-features" מאפשר את כל התכונות האופציונליות, ו-"--with-all-features" יכול
בחר תכונה להשבתה.

--configure-timeout, --build-timeout, --test-timeout
ציין את משך הזמן הקצוב (בשניות) להמתנה להגדרה, בנייה ובדיקה
תהליך. ערכי ברירת המחדל הנוכחיים הם: 60 עבור תצורה, 3600 עבור build ו-1800 עבור
מבחן.

--configure-args, --build-args, --test-args, --install-args
ניסיוני: העבר ארגומנטים עבור פקודות תצורה/בנייה/בדיקה/התקנה בהתאמה,
עבור מודול נתון להתקנה.

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

הארגומנט מופעל רק עבור המודול המועבר כארגומנט שורת פקודה, לא
תלות.

--סקנדפס
הוחלש: סורק את התלות של מודולים נתונים ומוציא את העץ בטקסט
פוּרמָט. (ראה "--פורמט" למטה לאפשרויות נוספות)

מכיוון שהפקודה הזו לא באמת מתקינה הפצות כלשהן, היא תהיה שימושית
זה על ידי הקלדה:

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", זה יהיה שימושי להפעלה חוזרת
התקנות על מכונות אחרות.

--שמור-דיסטס
מציין את נתיב הספרייה האופציונלי להעתקת כדורים שהורדו במראה ה-CPAN
מבנה ספריות תואם כלומר authors/id/A/AU/AUTHORS/Foo-Bar-version.tar.gz

אם ה-distro tarball לא הגיע מ-CPAN, למשל מקובץ מקומי או מ-
GitHub, אז זה יישמר תחת ספק/Foo-Bar-version.tar.gz.

--לא צללים
מסיר את ההתקנה של קובצי הצל של ההפצה שאתה מתקין. זֶה
מבטל את הבלבול אם אתה מנסה להתקין מודולי ליבה (חיים כפולים) מ
CPAN כנגד perl 5.10 ומעלה, או מודולים שהיו מבוססי XS אך עברו ל-
פרל טהור בגרסה כלשהי.

אם אתה מפעיל את cpanm בתור root ומשתמש ב-"INSTALL_BASE" או שווה ערך כדי לציין מותאם אישית
נתיב ההתקנה, עליך להשבית אפשרות זו כדי שלא תסיר את ההתקנה בטעות
מודולים חיים כפולים מהליבה כוללים נתיב.

ברירת המחדל היא true אם גרסת ה-perl שלך קטנה מ-5.12, ואתה יכול להשבית זאת
עם "--no-uninst-shadows".

הערה: מאז גרסה 1.3000 דגל זה כבוי כברירת מחדל עבור perl חדש מ
5.12, שכן עם 5.12 @INC מכיל את ספריית site_perl לפני ספריית הליבה של perl
נתיב, והסרת צללים אינה הכרחית יותר והיא גורמת נזק רב יותר על ידי מחיקה
קבצים מנתיב ספריית הליבה.

--הסר, -U
מסיר מודול מנתיב הספרייה. הוא מוצא רשימת חבילות עבור מודולים נתונים, ו
מסיר את כל הקבצים הכלולים באותה הפצה.

אם תפעיל את local::lib, זה מסיר רק קבצים מהספרייה המקומית::lib.

אם תנסה להסיר מודול בספריית "perl" (כלומר מודול ליבה), תופיע שגיאה
לְהֵקָלַע.

תתבקש תיבת דו-שיח לאשר את הקבצים שיש למחוק. אם תעבור את האפשרות "-f".
כמו כן, תיבת הדו-שיח תידלג והסרת ההתקנה תיאלץ.

---cascade-search
ניסיוני: מציין אם לבצע חיפוש מדורג כאשר אתה מציין מספר מראות
ולמראה אין מודול או שיש לו גרסה נמוכה יותר של המודול מאשר
ביקש. ברירת המחדל ל-false.

--דלג-מותקן
מציין אם מודול שניתן בשורת הפקודה ידלג אם הגרסה האחרונה שלו
זה כבר מותקן. ברירת המחדל לאמת.

הערה: משתנה הסביבה "PERL5LIB" צריך להיות מוגדר כהלכה כדי שזה יעבוד
עם מודולים מותקנים באמצעות local::lib, אלא אם אתה תמיד משתמש באפשרות "-l".

--דלג-מרוצה
ניסיוני: מציין אם מודול (וגרסה) הניתנים בשורת הפקודה הם
דילג אם זה כבר מותקן.

אם אתה רץ:

cpanm --דלג-מרוצה CGI DBI~1.2

cpanm לא יתקין אותם אם כבר יש לך CGI (לכל גרסאות) או שיש לך DBI
עם גרסה גבוהה מ-1.2. זה דומה ל-"--skip-installed" אבל תוך כדי
"--skip-installed" בודק אם האחרון גרסה של CPAN מותקנת,
"--דלג-מרוצה" בודק אם גרסה מבוקשת (או לא, כלומר כל גרסה).
מותקן.

ברירת המחדל ל-false.

--תאשר
ודא את תקינות קובצי ההפצה שאוחזרו מ-PAUSE באמצעות CHECKSUMS ו
חתימות (אם נמצאו). ברירת המחדל ל-false.

--report-perl-version
האם הוא מדווח על גרסת perl המותקנת מקומית לשרת האינטרנט השונים כ
חלק מ-User-Agent. ברירת המחדל היא true אלא אם כן משתני סביבה הקשורים ל-CI כגון
"TRAVIS", "CI" או "AUTOMATED_TESTING" מופעלים. אתה יכול להשבית אותו באמצעות
"--no-report-perl-version".

--ניקוי אוטומטי
מציין את מספר הימים שבהם פג תוקף ספריות העבודה של cpanm. ברירת המחדל היא 7,
כלומר ספריות עבודה ישנות ינוקו תוך שבוע אחד.

אתה יכול להגדיר את הערך ל-0 כדי לגרום ל-cpan לעולם לא לנקות את הספריות האלה.

--דפי אדם
יוצר דפי אדם עבור קובצי הפעלה (man1) וספריות (man3).

ברירת המחדל היא true (דפי אדם שנוצרו) אלא אם האפשרות "-L|--local-lib-contained" היא
מסופק ובמקרה זה מוגדר כ-false. אתה יכול להשבית אותו באמצעות "--no-man-pages".

--lwp
משתמש במודול LWP כדי להוריד דברים דרך HTTP. ברירת המחדל היא אמת, ואפשר לומר
"--no-lwp" כדי להשבית את השימוש ב-LWP, כאשר ברצונך לשדרג את LWP מ-CPAN על חלק מקולקל
מערכות perl.

--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 (בסדר הזה) ומשתמשת בראשון
אחד זמין.

השתמש ב-cpanmp באינטרנט באמצעות שירותי onworks.net