Node.js मैनुअल, भाग 5: npm और npx

आज, Node.js मैनुअल के अनुवाद के पांचवें भाग में, हम npm सुविधाओं के विश्लेषण को पूरा करेंगे, विशेष रूप से, हम ऐसे मुद्दों पर संपर्क करेंगे जैसे कि npm संकुल के संस्थापित संस्करण का पता लगाना, संकुल के पुराने संस्करणों को स्थापित करना, निर्भरता का स्थानीय और वैश्विक संस्थापन अद्यतन करना। यहाँ हम npx के बारे में बात करते हैं।

स्थापित npm संकुल के संस्करणों का पता लगाना

प्रोजेक्ट फ़ोल्डर में स्थापित सभी npm संकुल के संस्करणों का पता लगाने के लिए, उनकी निर्भरता सहित, निम्नलिखित कमांड चलाएँ:

npm list 

परिणामस्वरूप, उदाहरण के लिए, निम्नलिखित परिणाम हो सकता है:

 > npm list /Users/flavio/dev/node/cowsay └─┬ cowsay@1.3.1 ├── get-stdin@5.0.1 ├─┬ optimist@0.6.1 │ ├── minimist@0.0.10 │ └── wordwrap@0.0.3 ├─┬ string-width@2.1.1 │ ├── is-fullwidth-code-point@2.0.0 │ └─┬ strip-ansi@4.0.0 │  └── ansi-regex@3.0.0 └── strip-eof@1.0.0 

आप package-lock.json परियोजना के package-lock.json वही बात package-lock.json , लेकिन पेड़ की संरचना जो उपरोक्त कमांड प्रदर्शित करती है, वह देखने में अधिक सुविधाजनक है।

वैश्विक स्तर पर स्थापित पैकेजों की एक समान सूची प्राप्त करने के लिए, आप निम्न कमांड का उपयोग कर सकते हैं:

 npm list -g 

आप केवल स्थानीय शीर्ष-स्तरीय पैकेजों के बारे में जानकारी प्रदर्शित कर सकते हैं (अर्थात, जिन्हें आपने स्वयं स्थापित किया है और जिन्हें package.json में सूचीबद्ध किया गया है):

 npm list --depth=0 

परिणामस्वरूप, यदि, उदाहरण के लिए, आपने केवल गौशाला पैकेज स्थापित किया है, तो निम्न प्रदर्शित किया जाएगा:

 > npm list --depth=0 /Users/flavio/dev/node/cowsay └── cowsay@1.3.1 

किसी विशिष्ट पैकेज के संस्करण का पता लगाने के लिए, निम्नलिखित कमांड का उपयोग करें:

 npm list cowsay 

इसके कार्यान्वयन के परिणामस्वरूप, हमें लगभग निम्नलिखित मिलते हैं:

 > npm list cowsay /Users/flavio/dev/node/cowsay └── cowsay@1.3.1 

यह कमांड आपके द्वारा इंस्टॉल किए गए पैकेजों की निर्भरता संस्करणों का पता लगाने के लिए भी उपयुक्त है। इस स्थिति में, निर्भरता पैकेज का नाम उसके द्वारा पारित पैकेज के नाम के रूप में कार्य करता है, और कमांड का आउटपुट इस तरह होगा:

 > npm list minimist /Users/flavio/dev/node/cowsay └─┬ cowsay@1.3.1 └─┬ optimist@0.6.1   └── minimist@0.0.10 

इस संरचना में निर्भरता पैकेज के बारे में एक प्रविष्टि पर प्रकाश डाला जाएगा।

यदि आप जानना चाहते हैं कि npm रिपॉजिटरी में उपलब्ध पैकेज के नवीनतम संस्करण की संख्या क्या है, तो आपको निम्न फॉर्म की एक कमांड की आवश्यकता होगी:

 npm view [package_name] version 

जवाब में, वह पैकेज संस्करण संख्या जारी करती है:

 > npm view cowsay version 1.3.1 

Npm संकुल के पुराने संस्करण स्थापित करना

संगतता समस्याओं को हल करने के लिए npm पैकेज का एक पुराना संस्करण स्थापित करना आवश्यक हो सकता है। आप निम्नलिखित निर्माण का उपयोग करके npm से पैकेज के आवश्यक संस्करण को स्थापित कर सकते हैं:

 npm install <package>@<version> 

एक उदाहरण के रूप में हम जिस गाय के पैकेज का उपयोग कर रहे हैं, उस स्थिति में, npm install cowsay अपने नवीनतम संस्करण install cowsay स्थापित install cowsay (इस लेखन के समय 1.3.1)। यदि आपको इसका संस्करण 1.2.0 स्थापित करने की आवश्यकता है, तो इस कमांड का उपयोग करें:

 npm install cowsay@1.2.0 

आप वैश्विक पैकेज स्थापित करके संस्करण निर्दिष्ट कर सकते हैं:

 npm install -g webpack@4.16.4 

यदि आपको यह पता लगाने की आवश्यकता है कि पैकेज के कौन से संस्करण npm में उपलब्ध हैं, तो आप इस निर्माण की मदद से कर सकते हैं:

 npm view <package> versions 

यहाँ उसके काम के परिणाम का एक उदाहरण है:

 > npm view cowsay versions [ '1.0.0', '1.0.1', '1.0.2', '1.0.3', '1.1.0', '1.1.1', '1.1.2', '1.1.3', '1.1.4', '1.1.5', '1.1.6', '1.1.7', '1.1.8', '1.1.9', '1.2.0', '1.2.1', '1.3.0', '1.3.1' ] 

उनके नवीनतम संस्करणों के लिए परियोजना निर्भरता अद्यतन करना

जब आप npm install <packagename> प्रकार के कमांड के साथ एक पैकेज npm install <packagename> , तो नवीनतम संस्करण रिपॉजिटरी से डाउनलोड किया जाता है और node_modules फ़ोल्डर में रखा जाता है। इस स्थिति में, संबंधित प्रविष्टियाँ package.json और package-lock.json में प्रोजेक्ट फ़ोल्डर में जोड़े जाते हैं।

इसके अलावा, एक पैकेज स्थापित करके, npm अपनी निर्भरता को पाता है और स्थापित करता है।

मान लीजिए कि हम npm npm install cowsay चलाकर परिचित गौशाला पैकेज npm install cowsay । पैकेज प्रोजेक्ट के node_modules फ़ोल्डर में स्थापित किया जाएगा, और निम्नलिखित प्रविष्टि node_modules फ़ाइल में होगी:

 { "dependencies": {   "cowsay": "^1.3.1" } } 

package-lock.json में इस पैकेज के बारे में जानकारी भी शामिल होगी। यहाँ इसका एक टुकड़ा है:

 { "requires": true, "lockfileVersion": 1, "dependencies": {   "cowsay": {     "version": "1.3.1",     "resolved": "https://registry.npmjs.org/cowsay/-/cowsay-1.3.1.tgz",     "integrity": "sha512-3PVFe6FePVtPj1HTeLin9v8WyLl+VmM1l1H/5P+BTTDkMAjufp+0F9eLjzRnOHzVAYeIYFF5po5NjRrgefnRMQ==",     "requires": {       "get-stdin": "^5.0.1",       "optimist": "~0.6.1",       "string-width": "~2.1.1",       "strip-eof": "^1.0.0"     }   } } } 

इन दो फाइलों से आप यह पता लगा सकते हैं कि हमने गाय का संस्करण 1.3.1 स्थापित किया है, और यह कि पैकेज अद्यतन नियम ^1.3.1 रूप में निर्दिष्ट है। सामग्रियों की इस श्रृंखला के चौथे भाग में, हम पहले ही शब्दार्थ संस्करण के नियमों के बारे में बात कर चुके हैं। याद रखें कि इस प्रविष्टि का मतलब है कि npm पैकेज को अपडेट कर सकता है जब इसके छोटे और पैच संस्करण जारी किए जाते हैं।

यदि, उदाहरण के लिए, पैकेज का एक नया मामूली संस्करण सामने आता है और हम npm update कमांड चलाते हैं, तो पैकेज का स्थापित संस्करण अपडेट किया जाता है और स्थापित पैकेज के बारे में जानकारी package-lock.json फ़ाइल में अपडेट की package-lock.json है, और package.json . package-lock.json फ़ाइल अपरिवर्तित रहती है।

यह पता लगाने के लिए कि परियोजना में उपयोग किए गए पैकेजों के नए संस्करण जारी किए गए हैं, आप निम्न कमांड का उपयोग कर सकते हैं:

 npm outdated 

यहां एक प्रोजेक्ट के लिए इस कमांड के परिणाम दिए गए हैं जिनकी निर्भरता लंबे समय तक अपडेट नहीं की गई है:


पदावनत परियोजना निर्भरता का विश्लेषण

उपलब्ध पैकेज अद्यतनों में से कुछ उनकी प्रमुख रिलीज़ हैं, जिन्हें npm update कमांड निष्पादित होने पर अपडेट नहीं होगा। इस टीम द्वारा प्रमुख रिलीज़ के लिए अपग्रेड नहीं किया जाता है, क्योंकि उनमें (परिभाषा के अनुसार) बड़े बदलाव हो सकते हैं जो पिछली प्रमुख रिलीज़ के साथ पिछड़ी संगतता से अलग नहीं होते हैं, और एनपीएम डेवलपर को उन समस्याओं से बचाने के लिए प्रयास करता है जो इस तरह के पैकेज के उपयोग का कारण बन सकते हैं।

सभी उपयोग किए गए पैकेजों के नए प्रमुख संस्करणों में अपग्रेड करने के लिए, विश्व स्तर पर npm-check-updates पैकेज स्थापित करें:

 npm install -g npm-check-updates 

फिर उसके द्वारा दी गई उपयोगिता को चलाएं:

 ncu -u 

यह कमांड package.json फ़ाइल को अद्यतन करेगा, जो dependencies और devDependencies में उपयुक्त पैकेज संस्करणों के लिए निर्देशों में बदलाव कर रहा है। यह npm को npm update कमांड चलाने के बाद प्रोजेक्ट में उपयोग किए गए पैकेजों को नए प्रमुख संस्करणों में अपडेट करने की अनुमति देगा।

यदि आप अभी डाउनलोड किए गए प्रोजेक्ट के लिए नवीनतम पैकेज संस्करण स्थापित करना चाहते हैं, जिसमें अभी तक एक node_modules फ़ोल्डर नहीं है, तो node_modules npm update बजाय, node_modules npm install कमांड चलाएं।

संकुल की स्थानीय या वैश्विक स्थापना रद्द करें

पहले से स्थानीय रूप से इंस्टॉल किए गए पैकेज की स्थापना रद्द करने के लिए ( install <package-name> कमांड का उपयोग करके), इस तरह दिखने वाला कमांड चलाएँ:

 npm uninstall <package-name> 

यदि पैकेज वैश्विक रूप से स्थापित है, तो आपको इसे हटाने के लिए -g (--global ) ध्वज का उपयोग करना होगा। उदाहरण के लिए, एक समान कमांड इस तरह दिख सकती है:

 npm uninstall -g webpack 

ऐसी कमांड को निष्पादित करते समय, वर्तमान फ़ोल्डर कोई फर्क नहीं पड़ता।

पैकेजों की वैश्विक और स्थानीय स्थापना के बीच चयन के बारे में

विश्व स्तर पर पैकेज कब और क्यों सबसे अच्छे तरीके से स्थापित किए गए हैं? इस प्रश्न का उत्तर देने के लिए, आइए हम याद करें कि संकुल की स्थानीय और वैश्विक स्थापना कैसे भिन्न होती है:

• स्थानीय पैकेज उस निर्देशिका में स्थापित किए जाते हैं जिसमें वे प्रपत्र npm install <package-name> एक कमांड निष्पादित करते हैं। ऐसे पैकेज इस निर्देशिका में स्थित node_modules फ़ोल्डर में स्थित हैं।
• वैश्विक पैकेज एक विशेष फ़ोल्डर में स्थापित होते हैं (जो कि आपके सिस्टम की विशिष्ट सेटिंग्स पर निर्भर करता है), भले ही वे फॉर्म npm install -g <package-name> एक आदेश को निष्पादित करते हैं।

कोड में स्थानीय और वैश्विक पैकेज को जोड़ना एक समान है:

 require('package-name') 

तो पैकेज स्थापित करने का सबसे अच्छा तरीका क्या है?

सामान्य तौर पर, सभी पैकेज स्थानीय रूप से स्थापित किए जाने चाहिए। इसके कारण, यदि आपके पास दर्जनों Node.js परियोजनाएँ हैं, तो भी, यदि आवश्यक हो, तो एक ही पैकेज के विभिन्न संस्करणों के उपयोग को आप सुनिश्चित कर सकते हैं।

वैश्विक पैकेज को अपडेट करने से तथ्य यह होता है कि जिन परियोजनाओं में इसे लागू किया जाता है, वे इसकी नई रिलीज का उपयोग करेंगे। यह समझना आसान है कि परियोजना के समर्थन के मामले में, यह एक वास्तविक दुःस्वप्न बन सकता है, क्योंकि कुछ पैकेजों की नई रिलीज़ उनके पुराने संस्करणों के साथ असंगत हो सकती हैं।

यदि प्रत्येक परियोजना के पास पैकेज का अपना स्थानीय संस्करण है, भले ही यह संसाधनों की बर्बादी की तरह लग सकता है, यह नकारात्मक परिणामों से बचने के लिए एक बहुत ही कम शुल्क है जो कि परियोजना कोड के साथ केंद्रीय रूप से अपडेट किए गए पैकेजों के नए संस्करणों की असंगति के कारण हो सकता है।

पैकेजों को वैश्विक रूप से स्थापित किया जाना चाहिए जब वे कुछ उपयोगिताओं को कमांड लाइन से बुलाए जाते हैं जो कई परियोजनाओं में उपयोग किए जाते हैं।

इस तरह के पैकेजों को स्थानीय रूप से कमांड-लाइन उपयोगिताओं को चलाकर स्थापित किया जा सकता है जो वे npx का उपयोग करके प्रदान करते हैं, लेकिन कुछ पैकेज अभी भी विश्व स्तर पर बेहतर स्थापित हैं। ऐसे पैकेज जिनसे आप अच्छी तरह परिचित हो सकते हैं, उदाहरण के लिए, निम्नलिखित:

• NPM
• बनाने प्रतिक्रिया-ऐप
• Vue-CLI
• घुरघुराना-CLI
• कहवा
• प्रतिक्रिया देशी-CLI
• gatsby-CLI
• सदैव
• nodemon

यह संभव है कि आपके सिस्टम में पहले से ही विश्व स्तर पर पैकेज स्थापित हों। इस बारे में जानने के लिए, निम्नलिखित कमांड का उपयोग करें:

 npm list -g --depth 0 

परियोजना निर्भरता के बारे में

एक पैकेज को एक नियमित परियोजना पर निर्भरता के रूप में माना जाना चाहिए जब इसके कामकाज को सुनिश्चित करने के लिए आवश्यक हो, और कब - एक विकास निर्भरता के रूप में?

जब npm install <package-name> जैसी कमांड का उपयोग करके npm install <package-name> स्थापित किया जाता है npm install <package-name> यह एक नियमित निर्भरता के रूप में स्थापित होता है। इस तरह के पैकेज का एक रिकॉर्ड पैकेज की dependencies खंड में बनाया गया है। --save फ़ाइल (npm 5 से पहले, ऐसा रिकॉर्ड केवल --save ध्वज का उपयोग करके बनाया गया था, अब इसका उपयोग करना आवश्यक नहीं है)।

--save-dev फ्लैग का उपयोग करने से आप पैकेज को विकास निर्भरता के रूप में स्थापित कर सकते हैं। उसी समय, इसका एक रिकॉर्ड devDependencies फ़ाइल की devDependencies अनुभाग में बनाया गया है।

विकास निर्भरताएं पैकेज हैं जो एक परियोजना को विकसित करने की प्रक्रिया में आवश्यक हैं, इसके सामान्य कामकाज के दौरान, उन्हें आवश्यक नहीं है। ऐसे पैकेजों में शामिल हैं, उदाहरण के लिए, परीक्षण उपकरण, वेबपैक, बैबेल।

जब किसी प्रोजेक्ट को उसके फ़ोल्डर में npm install कमांड का उपयोग करके तैनात किया जाता है, जिसमें एक फ़ोल्डर होता है जिसमें package.json फ़ाइल होती है, तो यह सभी निर्भरता को स्थापित करेगा, क्योंकि npm मानता है कि इस तरह के इंस्टॉलेशन को प्रोजेक्ट पर काम करने के उद्देश्य से किया जाता है।

इसलिए, यदि पैकेज को उत्पादन में तैनात करने की आवश्यकता होती है, तो, इसे तैनात करते समय, आपको एनपीएम install --production का उपयोग करने की आवश्यकता होती है। --production ध्वज के लिए धन्यवाद, --production निर्भरताएं स्थापित नहीं की जाएंगी।

Npx उपयोगिता

अब हम एक बहुत शक्तिशाली टीम, npx के बारे में बात करेंगे, जो npm 5.2 में दिखाई दी थी। इसकी क्षमताओं में से एक npm संकुल में शामिल निष्पादन योग्य फाइलें चलाना है। हमने पहले ही गाय के पैकेज से एक समान फ़ाइल चलाने के लिए npx का उपयोग करने पर विचार किया है। अब इसके बारे में अधिक विस्तार से बात करते हैं।

▍Use npx स्थानीय कमांड चलाने को सरल बनाने के लिए

Node.js डेवलपर्स ने विश्व स्तर पर स्थापित किए जाने वाले पैकेज के रूप में कई निष्पादन योग्य फाइलें (उपयोगिताओं) प्रकाशित कीं, जो कि उनकी क्षमताओं के लिए सुविधाजनक पहुंच प्रदान करती थीं, क्योंकि आप उन्हें कमांड लाइन से केवल संबंधित कमांड का नाम दर्ज करके चला सकते थे। हालांकि, ऐसे वातावरण में काम करना बहुत असुविधाजनक था अगर एक ही पैकेज के विभिन्न संस्करणों को स्थापित करना आवश्यक था।

प्रपत्र npx commandname कमांड का एक कमांड का उपयोग परियोजना फ़ोल्डर में वांछित फ़ाइल के लिए स्वचालित रूप से खोज करता है node_modules । यह इस तरह की फ़ाइल के लिए सटीक मार्ग जानने की आवश्यकता को समाप्त करता है। यह पैकेज की वैश्विक स्थापना को भी अनावश्यक बनाता है, PATH सिस्टम चर के उपयोग के माध्यम से फ़ाइल सिस्टम में कहीं से भी इसे प्रदान करता है।

▍ उन्हें स्थापित करने की आवश्यकता के बिना उपयोगिताओं को बदलना

Npx की एक और दिलचस्प विशेषता है, जिसकी बदौलत उपयोगिताओं को पहली बार स्थापित किए बिना लॉन्च किया जा सकता है। यह मुख्य रूप से निम्नलिखित कारणों से उपयोगी है:

• उपयोगिताओं की कोई स्थापना की आवश्यकता नहीं है।
• आप @version निर्माण का उपयोग करके वांछित संस्करण निर्दिष्ट करके एक ही उपयोगिताओं के विभिन्न संस्करण चला सकते हैं।

आइए देखें कि इस तंत्र का उपयोग कैसे किया जाता है, cowsay उपयोगिता का उपयोग करके जिसे आप पहले से जानते हैं। इसलिए, यदि गायों का पैकेज विश्व स्तर पर स्थापित किया जाता है, तो कमांड लाइन पर cowsay "Hello" कमांड को निष्पादित करके "गाय" बात करने वाले कंसोल को आउटपुट मिलेगा:

 _______ < Hello > -------       \ ^__^        \ (oo)\_______           (__)\ )\/\               ||----w |               || || 

यदि वैश्विक रूप से गायों का पैकेज स्थापित नहीं किया गया है, तो एक समान कमांड एक त्रुटि फेंक देगा।

Npx उपयोगिता आपको इस तरह के आदेशों को स्थापित करने के बिना निष्पादित करने की अनुमति देती है। यह हमारे उदाहरण के ढांचे में दिखता है, जैसे:

 npx cowsay "Hello" 

इस तरह के एक कमांड काम करेगा, लेकिन हालांकि, एक "बात कर" गाय, और बड़े से, बहुत अधिक लाभ नहीं लाती है, एक ही दृष्टिकोण का उपयोग बहुत अधिक उपयोगी कमांड निष्पादित करने के लिए किया जा सकता है। यहाँ कुछ उदाहरण हैं:

• Vue एप्लिकेशन बनाने और चलाने के लिए डिज़ाइन किया गया एक कमांड लाइन टूल है। Npx के प्रयोग से इसे इस तरह कहा जा सकता है: npx vue create my-vue-app ।
• रिएक्ट create-react-app के create-react-app आप create-react-app यूटिलिटी का उपयोग कर सकते हैं। Npx के माध्यम से उसकी कॉल इस तरह दिखती है: npx create-react-app my-react-app ।

उपयुक्त npx कोड को डाउनलोड करने और उपयोग करने के बाद, इसे हटा दिया जाएगा।

▍ Node.js के विभिन्न संस्करणों का उपयोग करके जावास्क्रिप्ट कोड लॉन्च करना

Node.js के विभिन्न संस्करणों का उपयोग करके कुछ कोड चलाने के लिए, आप npx का उपयोग करके, npm पैकेज node तक पहुँच सकते हैं, इसके संस्करण का संकेत देते हैं। यह इस तरह दिखता है:

 npx node@6 -v #v6.14.3 npx node@8 -v #v8.11.3 

यह nvm या Node.js. के अन्य संस्करण प्रबंधकों जैसे टूल की आवश्यकता को समाप्त करता है

एक निश्चित पते पर उपलब्ध मनमाने ढंग से कोड टुकड़े ▍Start

Npx आपको न केवल npm में प्रकाशित कोड चलाने की अनुमति देता है। विशेष रूप से, यदि आपके पास कोड के एक निश्चित टुकड़े का लिंक है (जैसे, गिटहब पर प्रकाशित एक जिस्ट ), तो आप इसे इस तरह से चला सकते हैं:

 npx https://gist.github.com/zkat/4bc19503fe9e9309e2bfaa2c58074d32 

बेशक, ऐसे कोड को निष्पादित करते समय, आपको सुरक्षा के बारे में नहीं भूलना चाहिए। Npx डेवलपर को बहुत अच्छे अवसर देता है, लेकिन उनका मतलब महान जिम्मेदारी भी है।

▍ परिणाम

आज हमने कुछ उपयोगी npm तंत्र और npx के उपयोग के बारे में बात की। इस बिंदु पर, आपको npm डिवाइस की एक बुनियादी समझ और इस पैकेज प्रबंधक के साथ कैसे काम करना चाहिए। यदि आप npm पर एक गहरी नज़र रखना चाहते हैं, तो प्रोजेक्ट के दस्तावेज़ पृष्ठ देखें और अधिक प्रयोग करें।

अगली बार हम कुछ बुनियादी Node.js तंत्रों पर चर्चा करेंगे, जिनमें से एक समझ इस मंच के लिए सफल अनुप्रयोग विकास के लिए आवश्यक है।

प्रिय पाठकों! क्या आप npx का उपयोग करते हैं?