लर्निंग पायथन: अर्गपर्स मॉड्यूल

यदि आप पायथन का उपयोग करते हुए डेटा प्रोसेसिंग और विश्लेषण में शामिल हैं, तो, जल्दी या बाद में, आपको अपने कोड को जूपिटर नोटबुक से परे जाना होगा, अपने कोड को स्क्रिप्ट में परिवर्तित करना होगा जो कमांड लाइन का उपयोग करके चलाया जा सकता है। यह वह जगह है जहाँ argparse मॉड्यूल काम में आता है। शुरुआती लोगों के लिए, जुपिटर नोटबुक के आदी, इस कदम का मतलब है कि आराम क्षेत्र को छोड़कर एक नए वातावरण में स्थानांतरित होना। सामग्री, जिसका अनुवाद आज हम प्रकाशित करते हैं, ऐसे संक्रमण को सुविधाजनक बनाने के लिए लिखा जाता है।


अर्गपर्स मॉड्यूल

अर्गपर्स मॉड्यूल

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

यह ध्यान दिया जाना चाहिए कि कमांड लाइन के तर्कों के साथ काम करने के लिए argparse अनुशंसित मानक पायथन लाइब्रेरी मॉड्यूल है। मुझे शुरुआती लोगों के लिए एक अच्छा अर्गपर्स गाइड नहीं मिला, इसलिए मैंने खुद इस तरह का गाइड लिखने का फैसला किया।

बृहस्पति नोटबुक से परे जीवन

जब मैं पहली बार पायथन स्क्रिप्ट में आया था, जो मुझे अपने खाली समय में किए गए प्रोजेक्ट के लिए चाहिए था, तो मैंने सोचा: "यह रहस्यमय निर्माण क्या है?" उसके बाद, मैंने जल्दी से कोड को जुपिटर नोटबुक में स्थानांतरित कर दिया, लेकिन इस तरह का कदम तर्कहीन निकला।

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

तब से, मुझे यह पता चला कि मुझे बहुत अच्छा लगा और मुझे यह मॉड्यूल पसंद आया। अब मैं इसे पूरी तरह से महत्वपूर्ण मानता हूं। हालांकि, मास्टर करने के लिए यह इतना मुश्किल नहीं है।

हमें अर्गपर्स मॉड्यूल की आवश्यकता क्यों है?

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

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

उदाहरण

मान लीजिए कि आप OpenCV लाइब्रेरी का उपयोग करके वीडियो फ़ाइलों को नियमित छवियों में बदलने के लिए एक स्क्रिप्ट लिखना चाहते हैं। इस समस्या को हल करने के लिए स्क्रिप्ट के लिए, यह उस जगह को जानना होगा जहां वीडियो फ़ाइलों को संग्रहीत किया जाता है, और उस स्थान पर जहां आपको तैयार छवि डालने की आवश्यकता होती है। यही है, उसे दो फ़ोल्डरों के बारे में जानकारी चाहिए, जिन रास्तों पर, जो बहुत सुविधाजनक नहीं है, उन्हें स्क्रिप्ट कोड में हार्ड-कोड किया जा सकता है, या, जो बहुत बेहतर है, आप उपयोगकर्ता को स्क्रिप्ट चलाते समय कमांड-लाइन तर्क के रूप में दर्ज करके स्क्रिप्ट निर्दिष्ट करने दे सकते हैं। इस तरह के अवसर के साथ स्क्रिप्ट से लैस करने के लिए, argparse मॉड्यूल हमारे लिए उपयोगी है। यहाँ पर स्क्रिप्ट का भाग कैसा दिख सकता है (आइए इस स्क्रिप्ट को videos.py ), जिसमें कमांड लाइन के तर्क पार्स किए गए हैं:

 # videos.py import argparse parser = argparse.ArgumentParser(description='Videos to images') parser.add_argument('indir', type=str, help='Input dir for videos') parser.add_argument('outdir', type=str, help='Output dir for image') args = parser.parse_args() print(args.indir) 

यहां, फ़ाइल की शुरुआत में, argparse मॉड्यूल आयात किया जाता है। फिर, argparse.ArgumentParser() निर्माण का उपयोग करते हुए, इसके विवरण के साथ एक parser ऑब्जेक्ट बनाया जाता है। इसके बाद, parser.add_argument() विधि का उपयोग करते हुए, parser.add_argument() वैरिएबल का indir जाता indir , जिसमें वीडियो फ़ाइलों के साथ फ़ोल्डर में पथ लिखने की योजना है। उसी समय, यह इंगित किया जाता है कि इसका एक स्ट्रिंग प्रकार है, और इसके बारे में संदर्भ जानकारी भी सेट है। उसके बाद, उसी तरह से, outdir चर outdir जाता outdir , जिसमें उस फ़ोल्डर में पथ जिसमें स्क्रिप्ट को वीडियो फ़ाइलों के आधार पर बनाई गई छवियों को रखना होगा। अगले चरण में, कमांड लाइन तर्कों को पार्स करने का परिणाम args चर में हो जाता है। स्टार्टअप पर स्क्रिप्ट के लिए जो पास किया गया है, वह अब outdir ऑब्जेक्ट के outdir और outdir प्रॉपर्टी के रूप में उपलब्ध होगा। अब आप इन मूल्यों के साथ काम कर सकते हैं। इस मामले में, हम केवल कंसोल पर प्रिंट करते हैं कि indir तर्क में स्क्रिप्ट को क्या पास किया गया है।

इस स्क्रिप्ट को कमांड लाइन से कैसे चलाया जाए:

 python videos.py /videos /images 

ध्यान दें कि पंक्तियों /videos और /images को उद्धृत करने की आवश्यकता नहीं है। इस तरह से शुरू की गई एक स्क्रिप्ट टर्मिनल को लाइन /videos का उत्पादन करेगी, जिससे इसके कोड में दिए गए तर्कों का उपयोग करने की संभावना की पुष्टि होगी। यह एक्शन में अर्गपर्स का जादू है।


पार्सिंग कमांड लाइन तर्कों का जादू

अर्गपर्स विवरण

हमने बस एक साधारण से उदाहरण के साथ देखा। आइए अब कुछ विवरणों पर चर्चा करते हैं।

▍ स्थिति संबंधी तर्क

parser.add_argument('indir', type=str, help='Input dir for videos') से फॉर्म parser.add_argument('indir', type=str, help='Input dir for videos') का निर्माण एक videos.py तर्क बनाने के लिए है। किसी स्क्रिप्ट को कॉल करते समय, जिस क्रम में ऐसे तर्क निर्दिष्ट किए जाते हैं वह महत्वपूर्ण है। तो, स्क्रिप्ट के लिए दिया गया पहला तर्क पहला स्थैतिक तर्क बन जाता है, दूसरा तर्क दूसरा स्थितिक तर्क बन जाता है।

अगर टर्मिनल में python videos.py कमांड चलाकर स्क्रिप्ट को बिना किसी तर्क के चलाया जाता है तो क्या होगा?

इस स्थिति में, निम्न त्रुटि संदेश प्रदर्शित किया जाएगा:

 videos.py: error: the following arguments are required: indir, outdir 

नतीजतन, यह पता चला है कि एक स्क्रिप्ट चलाने के लिए जो स्थिति संबंधी तर्कों के उपयोग के लिए प्रदान करता है, इस तरह के तर्कों को हमेशा चलाया जाना चाहिए।

Ional वैकल्पिक तर्क

क्या होता है जब हमारी स्क्रिप्ट python videos.py --help कमांड से python videos.py --help ?

जवाब में, इसके बारे में जानकारी प्रदर्शित की जाएगी। यह वैचारिक तर्क के बारे में ठीक-ठीक जानकारी है जो हमने संबंधित चर का वर्णन करते समय इंगित की थी:

 usage: videos.py [-h] indir outdir Videos to images positional arguments: indir       Input dir for videos outdir      Output dir for image optional arguments: -h, --help  show this help message and exit 

स्क्रिप्ट ने हमें कई दिलचस्प बातें बताईं जो उपयोगकर्ता से अपेक्षा करती हैं, और help वैकल्पिक तर्क का एक उदाहरण है। ध्यान दें कि --help (या -h ) एकमात्र मानक वैकल्पिक तर्क है जिसका उपयोग हम argparse के साथ काम करते समय कर सकते हैं, लेकिन यदि आपको अन्य वैकल्पिक तर्क की आवश्यकता है, तो आप उन्हें स्वयं बना सकते हैं।

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

 parser.add_argument('-m', '--my_optional') 

वैकल्पिक तर्क बनाने और उनका उपयोग करने का तरीका यहां दिया गया है। ध्यान दें कि यहां वैकल्पिक तर्क का वर्णन करते समय, हमने इसके प्रकार को int रूप में निर्दिष्ट किया है। अर्थात यह पूर्णांक है। एक समान स्थिति में, आप अन्य प्रकार के पायथन का उपयोग कर सकते हैं।

 # my_example.py import argparse parser = argparse.ArgumentParser(description='My example explanation') parser.add_argument(   '--my_optional',   type=int,   default=2,   help='provide an integer (default: 2)' ) my_namespace = parser.parse_args() print(my_namespace.my_optional) 

इस तर्क को --my_optional रूप में वर्णित तर्क my_namespace नाम की एक संपत्ति के रूप में उपलब्ध है, जिसका नाम my_optional ।

वैकल्पिक तर्कों को उन मूल्यों को सौंपा जा सकता है जो उनके पास डिफ़ॉल्ट रूप से होंगे। हमारे मामले में, अगर स्क्रिप्ट को कॉल करने पर my_example तर्क को कोई मान नहीं दिया जाता है, तो नंबर 2 उस पर लिखा जाएगा, जो कंसोल पर आउटपुट होगा। स्क्रिप्ट निष्पादन के दौरान इस तर्क का मान सेट करने के लिए, आप निम्न निर्माण का उपयोग कर सकते हैं:

 python my_example.py  --my_optional=3 

और क्या कर सकते हैं के लिए इस्तेमाल किया जा सकता है?

पगड़ी अनुप्रयोगों को विकसित करने के लिए एर्गपर्स मॉड्यूल का उपयोग किया जा सकता है जो डॉकटर कंटेनरों में पैक किए जाने की योजना है। इसलिए, उदाहरण के लिए, यदि आपको कंटेनर में पैक किए गए एप्लिकेशन को शुरू करते समय कमांड लाइन के तर्कों को पास करने की आवश्यकता है, तो आप RUN निर्देश का उपयोग करके डॉकरफाइल में कंटेनर विधानसभा के चरण में इसका वर्णन कर सकते हैं। कंटेनर ENTRYPOINT दौरान स्क्रिप्ट चलाने के लिए आप CMD या ENTRYPOINT निर्देशों का उपयोग कर सकते हैं। डॉकफाइल्स के बारे में विवरण यहां पाया जा सकता है ।

परिणाम

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

यदि आप ज्यूपिटर नोटबुक के साथ काम करने के आदी हैं और इस प्रथा से दूर जाना चाहते हैं , तो आप यहाँ जाते हैं - सामग्री पर काम करने के लिए सामग्री। यहाँ repo2docker टूल की सामग्री दी गई है , जो आपको Jupyter Notebook repositories को Docker छवियों में बदलने की अनुमति देती है।

प्रिय पाठकों! पायथन लिपियों में कमांड लाइन के तर्कों के साथ आप कैसे काम करते हैं?