👶🏼 ⌛️ 👩‍⚖️ लार्ना और यार्न वर्कस्पेस के साथ एक मोनोरेपोजिटरी बनाएं 🧘🏿 👨🏼‍⚖️ 👨🏾‍✈️

पिछले कुछ वर्षों में, मोनो-रिपॉजिटरीज़ की अवधारणा ने सफलतापूर्वक खुद को स्थापित किया है, क्योंकि यह मॉड्यूलर सॉफ्टवेयर परियोजनाओं जैसे कि माइक्रोसो-आधारित इन्फ्रास्ट्रक्चर को विकसित करने की प्रक्रिया को काफी सरल कर सकता है। इस वास्तुशिल्प दृष्टिकोण के मुख्य लाभ व्यवहार में स्पष्ट हैं, इसलिए, मैं अपने स्वयं के परीक्षण मोनो-रिपॉजिटरी को खरोंच से बनाने का प्रस्ताव करता हूं, साथ ही साथ यार्न वर्कस्पेस और लर्न के साथ काम करने की बारीकियों को समझता हूं । खैर, चलो शुरू हो जाओ!

हमारी परियोजना की संरचना पर विचार करें, जो पैकेज / फ़ोल्डर में स्थित तीन पुस्तकालय, साथ ही साथ रूट निर्देशिका में package.json होगा ।

├── package.json └── packages ├── app │  ├── index.js │  └── package.json ├── first │  ├── index.js │  └── package.json └── second ├── index.js └── package.json

यह समझा जाता है कि हमारे पास पहले और दूसरे दो स्वतंत्र पुस्तकालय हैं, साथ ही एक ऐप पुस्तकालय भी है जो पहले दो से कार्यों का आयात करेगा। सुविधा के लिए, सभी तीन पैकेजों को संकुल निर्देशिका में रखा गया है। आप उन्हें रूट फ़ोल्डर में छोड़ सकते हैं या उन्हें किसी अन्य नाम के साथ निर्देशिका में रख सकते हैं, लेकिन आम तौर पर स्वीकृत सम्मेलनों का पालन करने के लिए, हम उन्हें इस तरह से जगह देंगे।

प्रयोग की सादगी के लिए पहले और दूसरे पुस्तकालयों में index.js में केवल एक फ़ंक्शन होगा, जिसमें से प्रत्येक मॉड्यूल की ओर से एक हैलो स्ट्रिंग लौटाएगा। पहले उदाहरण के लिए, यह इस तरह दिखेगा:

 // packages/first/index.js const first = () => 'Hi from the first module'; module.exports = first;

एप्लिकेशन मॉड्यूल में, हम कंसोल में ऐप से हाय , साथ ही दो अन्य पैकेजों से शुभकामना संदेश प्रदर्शित करेंगे:

 // packages/app/index.js const first = require('@monorepo/first'); const second = require('@monorepo/second'); const app = () => 'Hi from the app'; const main = () => { console.log(app()); console.log(first()); console.log(second()); }; main(); module.exports = { app, main };

ताकि ऐप में पहले और दूसरे उपलब्ध हैं, हम उन्हें निर्भरता में निर्भरता के रूप में निरूपित करते हैं।

इसके अलावा, प्रत्येक लाइब्रेरी के लिए हम पैकेज के मुख्य नाम के सामने मूल्य में नाम के उपसर्ग @ मोनोरपो / जोड़ते हैं ।

 // packages/app/package.json { "name": "@monorepo/app", "version": "1.0.0", "main": "index.js", "license": "MIT", "dependencies": { "@monorepo/first": "^1.0.0", "@monorepo/second": "^1.0.0" } }

मुझे पैकेज नाम npm (@ monorepo /) के सामने एक कुत्ते आइकन के साथ एक उपसर्ग की आवश्यकता क्यों है?

एक उपसर्ग जोड़ना वैकल्पिक है, लेकिन यह ठीक उसी तरह का पैकेज नामकरण सम्मेलन है जो कई मोनोरेपोज़िटरीज़ का पालन करते हैं: शिशुओं,
सामग्री ui , कोणीय और अन्य। तथ्य यह है कि प्रत्येक उपयोगकर्ता या संगठन की npm वेबसाइट पर अपना स्वयं का दायरा है , इसलिए इस बात की गारंटी है कि @ somescope / postfix के साथ सभी मॉड्यूल somescope टीम द्वारा बनाए गए हैं, और हमलावरों द्वारा नहीं। इसके अलावा, मॉड्यूल नाम को कॉल करना संभव हो जाता है जो पहले से ही लिया गया है। उदाहरण के लिए, आप केवल अपने स्वयं के बर्तन मॉड्यूल को नहीं बना सकते हैं और बना सकते हैं, क्योंकि इस तरह की लाइब्रेरी पहले से मौजूद है । हालाँकि, पोस्टफ़िक्स @ myscopename को जोड़ने / हम लाठी और युवा महिलाओं के साथ हमारे बर्तन ( @ myscopename / बर्तन ) प्राप्त कर सकते हैं।

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

यार्न कार्यस्थान

पूर्ण विकसित मोनो बनाने से पहले अंतिम स्पर्श - रिपॉजिटरी हमारी रिपॉजिटरी की जड़ में package.json का डिज़ाइन होगा। कार्यस्थान संपत्ति पर ध्यान दें - हमने पैकेज / * का मूल्य निर्दिष्ट किया, जिसका अर्थ है " पैकेज फ़ोल्डर में सभी उपकुंजियों"। हमारे मामले में, यह ऐप है , पहला , दूसरा ।

 // package.json { "name": "monorepo", "version": "1.0.0", "main": "packages/app/index.js", "license": "MIT", "private": true, "workspaces": [ "packages/*" ] }

इसके अलावा, "निजी": true को package.json में निर्दिष्ट किया जाना चाहिए, क्योंकि कार्यस्थान केवल निजी परियोजनाओं में उपलब्ध हैं।

सब कुछ बंद करने के लिए, रूट डायरेक्टरी से यार्न कमांड ( यार्न इनस्टॉल या एनपीएम इंस्टाल ) को निष्पादित करें। चूंकि ऐप मॉड्यूल में मौजूद निर्भरताएं रूट पैकेज में कार्यस्थान के रूप में परिभाषित की जाती हैं। वास्तव में, हम npm-रजिस्ट्री से कुछ भी डाउनलोड नहीं करेंगे, लेकिन बस हमारे पैकेज को "लिंक" करें।

 yarn

अब हम नोड कमांड निष्पादित कर सकते हैं । रूट निर्देशिका से जो स्क्रिप्ट को संकुल / एप / index.js फ़ाइल से चलाएगा।

 node .

आइए देखें कि यह कैसे काम करता है। यार्न को कॉल करके , हमने पैकेज फ़ोल्डर में हमारी निर्देशिका में नोड_मॉड्यूल्स में प्रतीकात्मक लिंक बनाए।

निर्भरता में इस रिश्ते के कारण, हमें एक बड़ा फायदा मिला - अब, पहले और दूसरे मॉड्यूल में बदलते समय, हमारा ऐप पुनर्निर्माण के बिना इन पैकेजों के वर्तमान संस्करण को प्राप्त करेगा। व्यवहार में, यह बहुत सुविधाजनक है, क्योंकि हम संकुल के स्थानीय विकास का संचालन कर सकते हैं, फिर भी उन्हें तीसरे पक्ष की निर्भरता के रूप में परिभाषित कर सकते हैं (जो वे अंततः बन जाते हैं)।

यार्न वर्कस्पेस के साथ काम करने से आपको जो अगला महत्वपूर्ण लाभ मिल सकता है वह है थर्ड-पार्टी डिपेंडेंसीज़ को स्टोर करने का संगठन।

शीर्ष स्तर पर निर्भरता संग्रहीत करने के बारे में अधिक जानें।

मान लीजिए कि हम पहले और दूसरे स्थान पर रहने की लाइब्रेरी का उपयोग करना चाहते थे। उपयुक्त निर्देशिकाओं से यार्न एड लॉश कमांड को निष्पादित करके , हम स्थानीय पैकेज के लिए एक अपडेट प्राप्त करेंगे। Json - पैकेज का वर्तमान संस्करण निर्भरता में दिखाई देगा।

 "dependencies": { "lodash": "^4.17.11" }

खुद को लॉश पैकेज के लिए - शारीरिक रूप से पुस्तकालय नोड स्तर पर एक बार मूल स्तर पर स्थापित किया जाएगा।
यदि बाहरी पैकेज का आवश्यक संस्करण (हमारे मामले में लॉश में ) पहले और दूसरे के लिए अलग है (उदाहरण के लिए, पहले आपको लॉश v3.0.0 की आवश्यकता है, और दूसरे v4.0.0 में ), तो निचले संस्करण ( 3.0.0 ) के साथ एक पैकेज रूट नोड_मॉडल को मिलेगा , और दूसरे मॉड्यूल के लिए लॉश संस्करण स्थानीय पैकेज / सेकंड / नोड_मॉड्यूल्स में संग्रहीत किया जाएगा।
फायदे के अलावा, इस दृष्टिकोण में मामूली नुकसान हो सकते हैं, जो यार्न अतिरिक्त झंडे की मदद से बायपास करने की अनुमति देता है। आप आधिकारिक दस्तावेज में ऐसी बारीकियों के बारे में अधिक पढ़ सकते हैं।

लर्न जोड़ें

लारना के साथ काम करने में पहला कदम पैकेज को स्थापित करना है। आमतौर पर वे एक वैश्विक इंस्टॉलेशन ( यार्न ग्लोबल ऐड लर्न या एनपीएम-जी लर्न ) करते हैं, लेकिन यदि आप सुनिश्चित नहीं हैं कि आप इस लाइब्रेरी का उपयोग करना चाहते हैं, तो आप npx का उपयोग करके कॉल का उपयोग कर सकते हैं।

हम रूट डायरेक्टरी से लेर्ना को इनिशियलाइज़ करेंगे:

 lerna init

वास्तव में, हमने एक कमांड की मदद से एक साथ कई क्रियाएं कीं: एक गिट रिपॉजिटरी बनाई (यदि इससे पहले इसे शुरू नहीं किया गया था), एक lerna.json फ़ाइल बनाई और हमारे रूट पैकेज को अपडेट किया। json ।

अब नई बनाई गई lerna.json फ़ाइल में , दो पंक्तियाँ जोड़ें - "npmClient": "यार्न" और "यूअरवर्क्सस्पेस": सच । अंतिम पंक्ति कहती है कि हम पहले से ही यार्न वर्कस्पेस का उपयोग करते हैं और पहले और दूसरे के प्रतीकात्मक लिंक के साथ ऐप / नोड_मॉडल फ़ोल्डर बनाने की कोई आवश्यकता नहीं है।

 // lerna.json { "npmClient": "yarn", "packages": [ "packages/*" ], "version": "1.0.0", "useWorkspaces": true }

लर्न के साथ टेस्ट

हमारे पुस्तकालयों के लिए लर्न ऐड टेस्ट के साथ काम करने की सुविधा दिखाने के लिए।
रूट डायरेक्टरी से, हम परीक्षण के लिए पैकेज स्थापित करते हैं - जेस्ट । कमांड चलाएँ:

 yarn add -DW jest

मुझे -DW ध्वज की आवश्यकता क्यों है?

-D (- देव) ध्वज की आवश्यकता है ताकि जेस्ट पैकेज को देव निर्भरता के रूप में स्थापित किया जाए, और -W फ्लैग (- इग्नोर-वर्कस्पेस-रूट-चेक) रूट स्तर पर स्थापना की अनुमति देता है (जिसकी हमें आवश्यकता है)।

अगला कदम हमारे पैकेज में एक परीक्षण फ़ाइल जोड़ना है। हमारे उदाहरण की सुविधा के लिए, हम सभी परीक्षणों को समान बनाएंगे। पहले उदाहरण के लिए, परीक्षण फ़ाइल इस तरह दिखाई देगी:

 // packages/first/test.js const first = require('.'); describe('first', () => { it('should return correct message', () => { const result = first(); expect(result).toBe('Hi from the first module'); }); });

हमें अपने प्रत्येक पुस्तकालय के पैकेज में परीक्षण चलाने के लिए एक स्क्रिप्ट जोड़ने की आवश्यकता है:

 // packages/*/package.json ... "scripts": { "test": "../../node_modules/.bin/jest --colors" }, ...

अंतिम स्पर्श रूट package.json को अद्यतन करेगा। एक परीक्षण स्क्रिप्ट जोड़ें जो लेर्ना रन टेस्ट --स्ट्रीम कहेगी । लेर्ना रन के बाद वाला पैरामीटर उस कमांड को परिभाषित करता है जिसे पैकेज / फ़ोल्डर से हमारे प्रत्येक पैकेज में बुलाया जाएगा, और -स्ट्रीम फ्लैग हमें टर्मिनल में परिणामों का आउटपुट देखने की अनुमति देगा।

नतीजतन, मूल निर्देशिका से package.json इस तरह दिखेगा:

 // package.json { "name": "monorepo", "version": "1.0.0", "main": "packages/app/index.js", "license": "MIT", "private": true, "workspaces": [ "packages/*" ], "scripts": { "test": "lerna run test --stream" }, "devDependencies": { "jest": "^24.7.1", "lerna": "^3.13.2" } }

अब, परीक्षणों को चलाने के लिए, हमें केवल अपनी परियोजना की जड़ से कमांड को चलाने की आवश्यकता है:

 yarn test

वर्जन को लर्न के साथ अपग्रेड करें

अगला लोकप्रिय कार्य, जिसके साथ लर्न गुणवत्ता का सामना कर सकता है, पैकेज संस्करणों को अद्यतन करने के लिए होगा। कल्पना कीजिए कि परीक्षणों को लागू करने के बाद, हमने अपने पुस्तकालयों को 1.0.0 से 2.0.0 तक अपग्रेड करने का निर्णय लिया। ऐसा करने के लिए, बस लाइन को "अद्यतन: संस्करण" जोड़ें: "lerna version --no-push" को रूट package.json के स्क्रिप्ट फ़ील्ड में, और फिर यार्न अद्यतन चलाएँ : रूट निर्देशिका से संस्करण । --नो-पुश फ्लैग को इसलिए जोड़ा जाता है ताकि संस्करण को अपडेट करने के बाद रिमोट रिपॉजिटरी में बदलाव नहीं भेजे जाएं, जो कि लर्न डिफ़ॉल्ट रूप से (इस ध्वज के बिना) करता है।

परिणामस्वरूप, हमारा मूल पैकेज.जॉन इस तरह दिखेगा:

 // package.json { "name": "monorepo", "version": "1.0.0", "main": "packages/app/index.js", "license": "MIT", "private": true, "workspaces": [ "packages/*" ], "scripts": { "test": "lerna run test --stream", "update:version": "lerna version --no-push" }, "devDependencies": { "jest": "^24.7.1", "lerna": "^3.13.2" } }

संस्करण अद्यतन स्क्रिप्ट चलाएँ:

 yarn update:version

अगला, हमें उस संस्करण का चयन करने के लिए कहा जाएगा जिसे हम स्विच करना चाहते हैं:

एंटर पर क्लिक करके हमें उन पैकेजों की एक सूची मिलती है जिनमें संस्करण अपडेट किया गया है।

हम वाई दर्ज करके अपडेट की पुष्टि करते हैं और हमें सफल अपडेट के बारे में एक संदेश मिलता है।

अगर हम git स्टेटस कमांड को चलाने की कोशिश करते हैं, तो हमें यह संदेश मिलता है कि कुछ भी करने के लिए प्रतिबद्ध नहीं है, वर्किंग ट्री क्लीन lerna वर्जन न केवल पैकेज वर्जन को अपडेट करता है, बल्कि नए वर्जन (हमारे मामले में v2.0.0) का संकेत देते हुए एक कमिट और टैग भी बनाता है।

लेर्ना संस्करण टीम के साथ काम करने की विशेषताएं

यदि आप लाइन "संस्करण" जोड़ते हैं: "lerna version --no-push" के बजाय "update: version": रूट पैकेज की स्क्रिप्ट फ़ील्ड में "lerna version --no-push" , तो आप संभवतः अनपेक्षित व्यवहार के पार आ सकते हैं। लाल सांत्वना। तथ्य यह है कि डिफ़ॉल्ट रूप से एनपीएम-स्क्रिप्ट पैकेज संस्करण को अपडेट करने के तुरंत बाद संस्करण कमांड (आरक्षित स्क्रिप्ट) को कॉल करता है, जो कि लार्ना संस्करण के लिए एक पुनरावर्ती कॉल की ओर जाता है। इस स्थिति से बचने के लिए, यह स्क्रिप्ट को एक अलग नाम देने के लिए पर्याप्त है, उदाहरण के लिए अद्यतन: संस्करण , जैसा कि हमारे उदाहरण में किया गया था।

निष्कर्ष

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

परीक्षण परियोजना भंडार से लिंक ।

लार्ना और यार्न वर्कस्पेस के साथ एक मोनोरेपोजिटरी बनाएं

यार्न कार्यस्थान

लर्न जोड़ें

लर्न के साथ टेस्ट

वर्जन को लर्न के साथ अपग्रेड करें

निष्कर्ष

More articles: