Python argparse गाइड: कमाण्डलाइन आर्गुमेन्टको विश्लेषण

1. argparse भनेको के हो? Python मा आधारभूत प्रयोग

argparse भनेको के हो

import argparse

parser = argparse.ArgumentParser(description="फाइल प्रक्रिया कार्यक्रम")
parser.add_argument("input_file", help="प्रक्रिया गर्ने फाइलको पथ")
args = parser.parse_args()

print(f"प्रक्रिया गर्ने फाइल: {args.input_file}")

2. argparse प्रयोग गर्ने कारण: CLI उपकरणको लागि उत्तम विकल्प

CLI उपकरण भनेको के हो?

argparse को फाइदाहरू

• लचिलो तर्क सेटिङ: अनिवार्य तर्क र वैकल्पिक तर्कको परिभाषा सजिलो छ, र प्रयोगकर्ताले प्रयोग गर्न सहज कार्यक्रम डिजाइन गर्न सकिन्छ।
• स्वचालित त्रुटि ह्यान्डलिङ: यदि तर्क कम छन् वा अवैध मान निर्दिष्ट गरिएको छ भने, argparse स्वचालित रूपमा त्रुटि सन्देश देखाउँछ।
• सहायता सन्देश: argparse डिफल्ट रूपमा --help विकल्प प्रदान गर्दछ, जसले प्रयोगकर्तालाई प्रयोग विधि सजिलै जाँच्न मद्दत गर्छ।

$ python script.py --help
usage: script.py [-h] input_file

positional arguments:
  input_file  प्रक्रिया गर्ने फाइल

optional arguments:
  -h, --help  show this help message and exit

3. argparse को आधारभूत संरचना: चरण अनुसार व्याख्या

ArgumentParser को निर्माण

parser = argparse.ArgumentParser(description="फाइल प्रक्रिया कार्यक्रम")

आर्ग्युमेन्टको थप

parser.add_argument("input_file", type=str, help="इनपुट फाइल निर्दिष्ट गर्नुहोस्")
parser.add_argument("--verbose", action="store_true", help="विस्तृत आउटपुट सक्षम गर्नुहोस्")

आर्ग्युमेन्टको विश्लेषण

args = parser.parse_args()

4. उदाहरण: argparse प्रयोग गरेर बनाइएको सरल Python कार्यक्रम

मूलभूत उदाहरण

import argparse

parser = argparse.ArgumentParser(description="फाइल प्रक्रिया गर्ने कार्यक्रम")
parser.add_argument("file", help="कृपया फाइलको पथ निर्दिष्ट गर्नुहोस्")
parser.add_argument("--verbose", action="store_true", help="विस्तृत आउटपुट सक्षम गर्नुहोस्")

args = parser.parse_args()

if args.verbose:
    print(f"फाइल '{args.file}' लाई विस्तृत मोडमा प्रक्रिया गर्दैछ")
else:
    print(f"फाइल '{args.file}' लाई प्रक्रिया गर्दैछ")

5. argparse को थाहा हुनुपर्ने सुविधाहरू

परस्पर बहिष्कृत तर्कहरू（Mutually Exclusive Arguments）

parser = argparse.ArgumentParser(description="परस्पर बहिष्कृत तर्कहरूको उदाहरण")
group = parser.add_mutually_exclusive_group()
group.add_argument("--foo", action="store_true", help="foo लाई सक्रिय गर्नुहोस्")
group.add_argument("--bar", action="store_true", help="bar लाई सक्रिय गर्नुहोस्")

args = parser.parse_args()

सब कमाण्ड

parser = argparse.ArgumentParser(description="सब कमाण्डको उदाहरण")
subparsers = parser.add_subparsers(dest="command")

install_parser = subparsers.add_parser('install')
install_parser.add_argument('package', help="स्थापना गर्नुपर्ने प्याकेजको नाम")

uninstall_parser = subparsers.add_parser('uninstall')
uninstall_parser.add_argument('package', help="अनइन्स्टल गर्नुपर्ने प्याकेजको नाम")

args = parser.parse_args()

if args.command == "install":
    print(f"प्याकेज {args.package} स्थापित गरिँदैछ")
elif args.command == "uninstall":
    print(f"प्याकेज {args.package} अनइन्स्टल गरिँदैछ")

6. argparse मा त्रुटि ह्यान्डलिंग र डिबगिङ

स्वचालित त्रुटि सन्देश

$ python script.py
usage: script.py [-h] --input INPUT
script.py: error: the following arguments are required: --input

अनुकूलित त्रुटि सन्देश

parser = argparse.ArgumentParser(description="अनुकूलित त्रुटि सन्देशको उदाहरण")
parser.add_argument("--input", required=True, help="कृपया इनपुट फाइल निर्दिष्ट गर्नुहोस्")

try:
    args = parser.parse_args()
except argparse.ArgumentError as err:
    print(f"त्रुटि: {err}")

7. argparse को वास्तविक संसारमा प्रयोगका उदाहरणहरू

स्वचालन उपकरणहरूमा प्रयोग

$ python data_processor.py --input data.csv --output results.json --verbose

ठूलो-स्तरका परियोजनाहरूमा प्रयोग

$ python package_manager.py install package_name

8. सारांश