این عوامل می توانند به شما در مدیریت موثر وابستگی های پروژه و جلوگیری از مشکلات سازگاری کمک کنند.
requirement.txt ابزاری حیاتی در پایتون برای مدیریت وابستگی های پروژه و اطمینان از همکاری روان بین توسعه دهندگان است. این به شما این امکان را می دهد که محیط توسعه دقیق مورد استفاده برای پروژه را در هر نقطه از آینده بازسازی کنید. همچنین تضمین می‌کند که پروژه شما با بهره‌مندی از رفع اشکال و ویژگی‌های جدید در زمان به‌روزرسانی، جاری می‌ماند.
درک نحوه عملکرد requires.txt فرآیند راه اندازی محیط توسعه شما را ساده می کند و در نتیجه در زمان شما صرفه جویی می کند. همچنین از مشکلات سازگاری در طول همکاری جلوگیری می کند.
1. استفاده از محیط های مجازی پایتون برای requirements.txt
محیط های مجازی برای استفاده موثر از requirement.txt ضروری هستند. آنها شما را قادر می سازند بسته ها را مستقل از نصب پایتون در سراسر سیستم نصب کنید. این به نوبه خود با جلوگیری از تضادها و اطمینان از سازگاری نسخه، قابلیت اطمینان و مدیریت پروژه شما را افزایش می دهد.
تعیین وابستگی ها در یک فایل requires.txt در یک محیط مجازی، کپسوله سازی نیازمندی های پروژه شما را تضمین می کند. این باعث می شود که بازتولید محیط مشابه در ماشین های مختلف آسان تر شود. این به این دلیل است که جداسازی تضمین می‌کند که پروژه شما مستقل باقی می‌ماند و با سایر پروژه‌های پایتون یا بسته‌های سطح سیستم تداخلی ندارد.
برای ایجاد یک محیط مجازی که آن را با پروژه خود مرتبط می کند، به دایرکتوری پروژه خود در ترمینال بروید و از دستور زیر استفاده کنید:
python -m venv myenv
# On Windows, use: myenv\Scripts\activate
source myenv/bin/activate
اکنون می توانید به مدیریت وابستگی های پروژه خود در محیط مجازی فعال ادامه دهید. مدیریت محیط مجازی مهارتی است که برای استفاده از فایل requires.txt مفید خواهد بود.
2. ایجاد request.txt با Pip Freeze
در حالی که امکان تولید و نگهداری فایل requirement.txt به صورت دستی وجود دارد، این روش می تواند مستعد خطا و زمان بر باشد. این امر به ویژه با رشد پروژه شما و تغییر وابستگی ها به وجود می آید. خوشبختانه، پایتون یک راه خودکار برای تولید یک فایل requires.txt ارائه می کند. این با استفاده از دستور pip freeze است. این دستور به نصب Pip در سیستم شما نیاز دارد اگر قبلاً آن را نصب نکرده باشید.
دستور pip freeze محیط مجازی فعال فعلی را اسکن می کند. سپس تمام بسته های نصب شده و نسخه های آنها را فهرست می کند. سپس می توانید این خروجی را به یک فایل requires.txt هدایت کنید. این کار شما را در تلاش برای ردیابی دستی و به روز رسانی وابستگی ها صرفه جویی می کند.
برای تولید خودکار یک فایل requires.txt با استفاده از pip freeze، محیط مجازی خود را فعال کرده و دستور زیر را اجرا کنید:
pip freeze > requirements.txt
این دستور فایل requires.txt را با وضعیت فعلی محیط مجازی شما ایجاد می کند. فایل در فهرست کار فعلی شما ذخیره می شود. اگر قبلاً یک فایل requires.txt دارید، وابستگی ها را با موارد به روز شده بازنویسی می کند. این یک راه آسان برای به روز نگه داشتن وابستگی های پروژه شما بدون نیاز به به روز رسانی دستی فایل است.
3. Personalizing File Names: The Power of requirements.txt
فایلی که وابستگی‌های پروژه را فهرست می‌کند، به‌طور پیش‌فرض، requires.txt نام دارد. با این حال، می‌توانید انتخاب کنید که نام توصیفی تری به این فایل بدهید که با هدف پروژه شما همسو باشد. این زمانی که روی چندین پروژه به طور همزمان کار می کنید مفید است.
نام معنی دار وضوح پروژه را افزایش می دهد. این کار درک هدف آن را برای شما و همکارانتان آسان تر می کند. به عنوان مثال، هنگامی که روی یک پروژه برنامه کاربردی وب کار می کنید، می توانید نام فایل را webapp-requirements.txt یا flask-project-requirements.txt بگذارید. هنگامی که چندین فایل requires.txt در فهرست های مختلف پروژه دارید، سردرگمی را از بین می برد.
برای تولید یک فایل request.txt سفارشی از دستور زیر استفاده کنید.
pip freeze > webapp-requirements.txt
مطمئن شوید که برنامه وب را با نام دلخواه خود جایگزین کرده اید.
4. مدیریت محیط های مختلف
توسعه پایتون اغلب شامل کار بر روی چندین پروژه است. هر یک از این پروژه ها مجموعه ای از وابستگی ها و الزامات منحصر به فرد خود را دارند. مدیریت موثر این محیط های متنوع برای اطمینان از اینکه پروژه های شما ایزوله و قابل نگهداری باقی می مانند بسیار مهم است. فایل requires.txt نقش حیاتی در این فرآیند ایفا می کند. این به شما امکان می دهد وابستگی های خاص پروژه را برای محیط های مختلف مستندسازی و مدیریت کنید.
این بدان معناست که شما می توانید محیط های مجازی را برای پروژه های مختلف ایجاد، فعال و غیرفعال کنید. اطمینان از اینکه هر محیط دارای فایل requires.txt خاص خود است که وابستگی های خاص پروژه را مشخص می کند. این امر وابستگی های پروژه شما را منظم نگه می دارد و خطر تضاد بین پروژه های مختلف را کاهش می دهد.
5. مدیریت وابستگی انعطاف پذیر: حذف نسخه های کتابخانه
در یک فایل requires.txt معمولی، هر کتابخانه را با یک شماره نسخه خاص فهرست می‌کنید. با این حال، سناریوهایی وجود دارد که در آن تعیین نسخه دقیق ممکن است بهترین رویکرد نباشد. برخی از این سناریوها عبارتند از:
یکپارچه سازی و استقرار مداوم (CI/CD): در خطوط لوله CI/CD، باید مطمئن شوید که پروژه شما با آخرین نسخه سازگار یک وابستگی کار می کند. تعیین یک نسخه دقیق پروژه شما را به یک نسخه خاص قفل می کند. این مانع از فرآیندهای آزمایش و استقرار خودکار می شود. حذف نسخه به شما امکان می دهد در طول CI/CD به طور خودکار به آخرین نسخه سازگار به روز رسانی کنید.
# Instead of specifying an exact version
requests==2.26.0
# Omit the version to use the latest compatible version during CI/CD
requests
کتابخانه‌هایی با به‌روزرسانی‌های مکرر: برخی از کتابخانه‌ها به‌روزرسانی‌های مکرر، رفع اشکال‌ها و وصله‌های امنیتی دارند. در چنین مواردی، تعیین یک نسخه دقیق منجر به استفاده از نسخه قدیمی یا آسیب پذیر می شود. حذف نسخه تضمین می کند که هر بار که محیط خود را بازسازی می کنید آخرین نسخه پایدار را دریافت می کنید.
همکاری در پروژه‌های منبع باز: هنگام همکاری در پروژه‌های منبع باز با مشارکت‌کننده‌های متعدد، مشخص کردن نسخه‌های دقیق برای هر وابستگی می‌تواند فایل requires.txt را مستعد درگیری کند. حذف نسخه ها با دادن آزادی مشارکت کنندگان برای کار با نسخه های سازگار وابستگی ها، همکاری را تشویق می کند.
حذف شماره‌های نسخه خاص در فایل requires.txt انعطاف‌پذیری بیشتری در مدیریت وابستگی فراهم می‌کند. وقتی نسخه‌ها را حذف می‌کنید، pip سعی می‌کند آخرین نسخه سازگار هر کتابخانه را نصب کند. اگر می خواهید مطمئن شوید که پروژه شما همیشه از آخرین نسخه سازگار استفاده می کند، بدون نیاز به به روز رسانی دستی فایل requires.txt، این کار مفید است.
6. نصب کتابخانه ها از requires.txt
نصب کتابخانه ها از یک فایل require.txt یک گام اساسی در توسعه پایتون است. این تضمین می‌کند که پروژه شما تمام وابستگی‌های لازم را دارد. هنگامی که یک فایل requires.txt به خوبی نگهداری می کنید، نصب تمام وابستگی های پروژه بر روی یک سیستم جدید ساده است.
برای نصب وابستگی های مورد نیاز در محیط خود از دستور زیر استفاده کنید.
pip install -r requirements.txt
گاهی اوقات ممکن است با خطایی مواجه شوید که نشان می دهد فایل پیدا نشد. این به این دلیل است که شما ممکن است فرض کرده باشید که فایل دارای مشخصات.txt است اما پروژه ای که روی آن کار می کنید از یک پروژه سفارشی استفاده می کند. همیشه قبل از تلاش برای نصب وابستگی ها، نام مرتبط با این فایل را بررسی کنید.
نگهداری از فایل request.txt شما
به یاد داشته باشید که فایل requires.txt در سنگ تنظیم نشده است. باید با رشد پروژه شما و تغییر وابستگی ها تکامل یابد. مطمئن شوید که به طور منظم آن را به روز کرده و مرور کنید. این برای اطمینان از اینکه پروژه های پایتون شما قوی و قابل نگهداری باقی می مانند.