pip, venv और Project Environment

Virtual environment क्यों?

मान लीजिए एक laptop पर दो projects हैं: school report app जिसे pandas 1.5 चाहिए और नया dashboard जिसे pandas 2.2। दोनों एक ही global Python इस्तेमाल करें तो एक install करने से दूसरा टूट जाता है। Virtual environment (venv) हर project के लिए packages का अलग निजी folder है।

Step 1: environment बनाएँ

Terminal को अपने project folder के अंदर खोलें (VS Code में: Terminal → New Terminal) और चलाएँ:

# Windows
py -m venv .venv

# macOS / Linux
python3 -m venv .venv

इससे .venv नाम का छिपा folder बनता है जिसमें Python launcher और pip की अपनी copy होती है। .venv नाम आम convention है – VS Code इसे अपने-आप पहचानता है।

Step 2: activate करें

Activate होने के बाद prompt (.venv) से शुरू होता है। जाँचें कि Python अब project folder से आ रहा है:

(.venv) $ python -m pip --version
(.venv) $ pip list

नए environment में सिर्फ़ pip होता है – आपके global packages नहीं। (आपके version numbers अलग होंगे; यह run Python 3.13 पर था।)

Step 3: pip से packages install करें

pip install requests              # latest version
pip install requests==2.32.3      # exact version
pip install "pandas>=2,<3"        # any 2.x version
pip install --upgrade requests    # update
pip uninstall requests            # remove
pip show requests                 # details: version, location, dependencies

requests install करने पर उसकी ज़रूरत वाले packages भी install होते हैं। pip install requests==2.32.3 के बाद pip freeze ने यह दिखाया:

Step 4: requirements.txt से project share करें

# save the exact versions you are using
pip freeze > requirements.txt

# on another computer (after creating and activating a new .venv)
pip install -r requirements.txt

आपका Python code भी देख सकता है कि कौन से versions install हैं – bug reports में उपयोगी:

import sys
from importlib import metadata

print("Python", sys.version.split()[0])
print("inside a venv:", sys.prefix != sys.base_prefix)
for pkg in ["pip", "not-a-real-package"]:
    try:
        print(pkg, metadata.version(pkg))
    except metadata.PackageNotFoundError:
        print(pkg, "is not installed")

Step 5: .venv को Git से बाहर रखें

.venv folder बड़ा है और सिर्फ़ आपके computer के लिए है। इसे कभी upload या दूसरे PC पर copy न करें। इसकी जगह requirements.txt commit करें और .gitignore में यह line जोड़ें:

.venv/
__pycache__/

साफ़ project layout

school-report/
├── .venv/              ← not committed
├── .gitignore
├── requirements.txt
├── README.md
├── report.py
└── data/
    └── marks.csv

आम errors और सुधार

अभ्यास

1. weather-app folder बनाकर venv बनाएँ, requests install करें और requirements.txt save करें।
2. .venv delete करके environment सिर्फ़ requirements.txt से दोबारा बनाएँ।
3. check_env.py को venv के अंदर और बाहर चलाकर “inside a venv” line की तुलना करें।
4. VS Code में .venv interpreter चुनकर Run button से file चलाएँ।

सारांश

• एक project = एक .venv: python -m venv .venv।
• काम से पहले activate करें; prompt में (.venv) दिखता है।
• python -m pip install से install करें; pip freeze > requirements.txt से versions लिखें।
• requirements.txt commit करें, .venv ignore करें।