انجام پروژه با PIP3 و مدیریت پکیج‌های پایتون

هنگام انجام پروژه‌های دانشگاهی، شبیه‌سازی‌های پژوهشی و پیاده‌سازی مقالات با پایتون، یکی از بزرگ‌ترین چالش‌ها، به‌هم‌ریختگی کتابخانه‌ها و عدم اجرای کدهای شما روی سیستم استاد راهنما یا سرور دانشگاه است. این مقاله به شما آموزش می‌دهد چگونه با استفاده از ابزار PIP3 و ایجاد محیط‌های مجازی، پکیج‌های پایتون را به‌صورت استاندارد مدیریت کنید تا کدهایتان در هر سیستمی بدون خطا و به‌صورت کاملاً تکرارپذیر اجرا شوند.

۱. چرا مدیریت پکیج در پروژه‌های علمی حیاتی است؟

پاسخ کوتاه: مدیریت پکیج با ابزار PIP3 و استفاده از محیط‌های مجازی مانع از تداخل نسخه‌های مختلف کتابخانه‌ها شده و تضمین می‌کند که پروژه پژوهشی شما دقیقاً با همان نسخه‌هایی که توسعه یافته، در سیستم‌های دیگر نیز بدون خطا بازسازی و اجرا شود.

در کارهای پژوهشی، تکرارپذیری (Reproducibility) نتایج اهمیت ویژه‌ای دارد. اگر امروز پروژه خود را با نسخه‌ای خاص از کتابخانه TensorFlow یا PyTorch پیاده‌سازی کنید و شش ماه دیگر بدون مدیریت دقیق پکیج‌ها قصد اجرای مجدد آن را داشته باشید، آپدیت شدن خودکار این کتابخانه‌ها می‌تواند کدهای شما را کاملاً از کار بیندازد یا حتی نتایج عددی شبیه‌سازی را تغییر دهد. بنابراین، تسلط بر ابزار رسمی پایتون یعنی PIP3 یک مهارت پایه‌ای برای هر پژوهشگر است.

۲. ایجاد محیط مجازی (Virtual Environment)؛ گام اول و الزامی

پاسخ کوتاه: محیط مجازی یک پوشه ایزوله روی سیستم شماست که پایتون و مفسر آن را به همراه تمام پکیج‌های مورد نیاز پروژه، جدا از سیستم‌عامل نگهداری می‌کند تا از تداخل نسخه‌ها جلوگیری شود.

قبل از اینکه هرگونه پکیجی را با استفاده از PIP3 نصب کنید، باید یک محیط مجازی بسازید. برای این کار مراحل زیر را به ترتیب در ترمینال یا خط فرمان (Command Prompt) خود اجرا کنید:

1. ورود به پوشه پروژه: ابتدا با دستور cd به پوشه اصلی پروژه خود بروید:

   cd path/to/your/project

2. ساخت محیط مجازی: با استفاده از ابزار پیش‌فرض پایتون (venv)، محیط مجازی خود را ایجاد کنید. نام این محیط را معمولاً .venv یا env می‌گذارند:

   python3 -m venv .venv

3. فعال‌سازی محیط مجازی: بسته به سیستم‌عامل خود، دستور مناسب را وارد کنید:
   • در ویندوز (cmd): .venvScriptsactivate
   • در مک و لینوکس: source .venv/bin/activate

۳. دستورات کاربردی PIP3 برای مدیریت پکیج‌ها

پاسخ کوتاه: دستورات اصلی PIP3 شامل نصب (install)، به‌روزرسانی (install –upgrade)، حذف (uninstall) و مشاهده پکیج‌های نصب شده (list) هستند که مدیریت کامل چرخه حیات کتابخانه‌ها را ممکن می‌سازند.

ابزار PIP3 مدیر پکیج رسمی برای پایتون ۳ است. در ادامه پرکاربردترین دستورات این ابزار را که در جریان توسعه پروژه به آن‌ها نیاز دارید بررسی می‌کنیم:

نصب یک پکیج با نسخه مشخص

برای جلوگیری از تغییرات ناخواسته، همیشه توصیه می‌شود نسخه‌ای مشخص از کتابخانه را نصب کنید. به عنوان مثال، برای نصب نسخه خاصی از کتابخانه محبوب NumPy:

pip3 install numpy==1.24.3

به‌روزرسانی یک پکیج

اگر تمایل دارید کتابخانه‌ای را به آخرین نسخه پایدار ارتقا دهید، از پرچم --upgrade یا -U استفاده کنید:

pip3 install --upgrade pandas

حذف یک پکیج اضافی

برای سبک نگه داشتن پروژه و حذف پکیج‌هایی که دیگر به آن‌ها نیاز ندارید:

pip3 uninstall matplotlib

۴. مستندسازی وابستگی‌ها با فایل requirements.txt

پاسخ کوتاه: فایل requirements.txt سندی متنی حاوی تمام کتابخانه‌ها و نسخه‌های دقیق استفاده شده در پروژه شماست که امکان بازسازی سریع کل محیط پروژه را در سیستم دیگر با یک دستور فراهم می‌کند.

هنگامی که پروژه خود را به استاد، همکار یا داور ژورنال تحویل می‌دهید، نباید پوشه محیط مجازی (.venv) را ارسال کنید، زیرا این پوشه سنگین و وابسته به سخت‌افزار سیستم شماست. در عوض، باید یک فایل متنی سبک به نام requirements.txt ایجاد کنید.

گام اول: استخراج پکیج‌های نصب شده (تولید فایل)

زمانی که پروژه شما کامل شد، دستور زیر را در خط فرمان (در حالی که محیط مجازی فعال است) بنویسید تا لیست تمام پکیج‌ها در فایل ذخیره شود:

pip3 freeze > requirements.txt

گام دوم: نصب پکیج‌ها روی سیستم جدید (بازسازی پروژه)

شخص دوم (مثلاً استاد راهنما) برای اجرای پروژه شما کافی است ابتدا یک محیط مجازی بسازد، آن را فعال کند و سپس با دستور زیر تمام وابستگی‌ها را با همان نسخه‌های دقیق نصب کند:

pip3 install -r requirements.txt

۵. مقایسه نصب پکیج به‌صورت سراسری در مقابل محیط مجازی

جدول زیر به شما نشان می‌دهد که چرا هرگز نباید پکیج‌های پروژه خود را به صورت سراسری (Global) روی سیستم‌عامل نصب کنید و چرا استفاده از محیط مجازی برتری مطلق دارد:

۶. اشتباهات رایج دانشجویان و راه‌حل‌های سریع

در انجام پروژه‌های دانشجویی و پژوهشی، معمولاً خطاهای مشابهی در کار با پایتون رخ می‌دهد. در ادامه راه‌حل‌های سریع برای رفع این مشکلات را آورده‌ایم:

• اشتباه ۱: استفاده از sudo pip3 install در لینوکس یا مک

  راه‌حل: این کار فایل‌های سیستمی مفسر پایتون را خراب می‌کند. هرگز از sudo برای نصب پکیج استفاده نکنید. همیشه ابتدا یک محیط مجازی (venv) بسازید و سپس بدون نیاز به دسترسی root، دستور pip3 install را اجرا کنید.

• اشتباه ۲: فراموش کردن فعال‌سازی محیط مجازی

  راه‌حل: اگر پکیجی نصب کردید اما هنگام اجرای کد با خطای ModuleNotFoundError مواجه شدید، بررسی کنید که آیا نام محیط مجازی در پرانتز ابتدای خط ترمینال دیده می‌شود یا خیر. اگر نیست، مجدداً دستور activate را اجرا کنید.

• اشتباه ۳: آپلود کردن کل پوشه .venv یا env روی گیت‌هاب

  راه‌حل: پوشه محیط مجازی حاوی هزاران فایل کوچک و سنگین است. همیشه نام پوشه محیط مجازی (مثلاً .venv/) را در فایل .gitignore قرار دهید و فقط فایل requirements.txt را به مخزن گیت اضافه کنید.

• اشتباه ۴: مخلوط کردن پکیج‌های Conda و PIP3 بدون برنامه‌ریزی

  راه‌حل: اگر از توزیع آناکوندا استفاده می‌کنید، ترجیحاً پکیج‌ها را با دستور conda install نصب کنید. اگر پکیج در کانال‌های کندا نبود، ابتدا محیط کندا را فعال کرده و سپس از pip3 install استفاده کنید تا تداخلی رخ ندهد.

۷. پرسش‌های متداول (FAQ)