मॉड्यूल, आयात और पैकेज कैसे काम करते हैं?

Question

Accepted Answer

एक **मॉड्यूल** एक एकल `.py` फ़ाइल है; एक **पैकेज** मॉड्यूल की एक निर्देशिका है। **आयात** आपको अन्य मॉड्यूल से कोड का उपयोग करने देते हैं, एक प्रोग्राम को पुन: उपयोग करने योग्य टुकड़ों में संगठित करते हैं।

## मॉड्यूल और आयात

```python
# math_utils.py — a module
def add(a, b): return a + b
PI = 3.14159
```

```python
# main.py — different ways to import
import math_utils                  # import the whole module
math_utils.add(2, 3)               # access via the module name

from math_utils import add, PI     # import specific names
add(2, 3)                          # use directly

from math_utils import add as plus # import with an alias
import numpy as np                 # common aliasing convention
```

## पैकेज — मॉड्यूल की निर्देशिकाएं

```text
mypackage/
  __init__.py        ← marks it as a package (can be empty)
  module_a.py
  subpackage/
    __init__.py
    module_b.py
```

```python
from mypackage.module_a import something
from mypackage.subpackage.module_b import other
```

`__init__.py` फ़ाइल एक निर्देशिका को पैकेज के रूप में चिह्नित करती है (और पैकेज-init कोड चला सकती है या परिभाषित कर सकती है कि `from package import *` क्या प्रदर्शित करता है)।

## `if __name__ == "__main__"` मुहावरा

```python
def main():
    print("running as a script")

if __name__ == "__main__":   # True only when run directly, not when imported
    main()
```

यह एक फ़ाइल को एक आयात योग्य मॉड्यूल *और* एक चलाने योग्य स्क्रिप्ट दोनों के रूप में कार्य करने देता है — इसके अंतर्गत कोड तभी चलता है जब फ़ाइल सीधे चलाई जाती है (`python file.py`), आयात के समय नहीं। लगभग सार्वभौमिक Python मुहावरा।

## Python मॉड्यूल कहां ढूंढता है

```python
import sys
sys.path   # the list of directories Python searches for imports
# includes: the current directory, installed packages (site-packages), stdlib
```

## मानक लाइब्रेरी और तीसरे पक्ष

```python
import os, json, datetime    # standard library — "batteries included"
import requests              # third-party — installed via pip from PyPI
```

## यह क्यों महत्वपूर्ण है

मॉड्यूल और पैकेज यह हैं कि आप Python कोड को पुन: उपयोग करने योग्य, रखरखाव योग्य इकाइयों में कैसे संगठित करते हैं बजाय एक विशाल फ़ाइल के — किसी भी गैर-तुच्छ परियोजना के लिए मौलिक।

आयात शैलियों, पैकेज संरचना (`__init__.py`), `if __name__ == "__main__"` मुहावरा (दोहरी स्क्रिप्ट/मॉड्यूल व्यवहार), और Python कैसे मॉड्यूल खोजता है (`sys.path`) को समझना परियोजनाओं को संरचित करने, कोड का पुन: उपयोग करने, और विशाल मानक लाइब्रेरी और PyPI पारिस्थितिकी तंत्र का उपयोग करने के लिए आवश्यक है।

आयात त्रुटियां और संरचना भ्रम सामान्य प्रारंभिक बाधाएं हैं जिन्हें यह ज्ञान हल करता है।

मॉड्यूल और आयात

पैकेज — मॉड्यूल की निर्देशिकाएं

if __name__ == "__main__" मुहावरा

Python मॉड्यूल कहां ढूंढता है

मानक लाइब्रेरी और तीसरे पक्ष

यह क्यों महत्वपूर्ण है

`if name == "main"` मुहावरा