ابرقدرت های Python خود را با “UV Run” آمپر کنید

ابزار UV به شما امکان می دهد بسته ها و کتابخانه های پایتون را با یک دستور و بدون تنظیم اجرا کنید. در اینجا راهنمای سریع اجرای بسته های پایتون بدون نصب آنها آورده شده است.

Astral ابزار UV تنظیم محیط های پایتون و پروژه های سریع و سریع و آسان است. همچنین به شما ابزاری برای اجرای بسته ها و کتابخانه های موجود در پایتون موجود بدون نیاز به نصب رسمی آنها می دهد.

هنگامی که از UV Run برای اجرای یک برنامه Python استفاده می کنید ، UV به طور خودکار اجزای مورد نیاز را واکشی می کند ، یک محیط موقت را برای آنها تنظیم می کند و برنامه را راه اندازی می کند. UV مرحله این کارها را به صورت خودکار مدیریت می کند ، بنابراین توسعه دهندگان فقط می توانند با نمایش ادامه دهند.

مبانی “اجرای UV” برای بسته ها و کتابخانه ها

وقتی از UV Run استفاده می کنید ، معمولاً فقط به نام python می خواهید اجرا کنید. به عنوان نمونه ، عبور UV run myfile.py را اجرا می کند myfile.py “همانطور که هست” ، تنها با آنچه در حال حاضر در محیط نصب شده است UV Run استفاده می کند. اگر این برنامه به وابستگی های شخص ثالث حذف نشده نیاز داشته باشد ، نمی تواند آنها را پیدا کند.

اگر می خواهید آن وابستگی ها را اضافه کنید ، می توانید را با به UV Run اضافه کنید. اگر به کتابخانه شخص ثالث نیاز دارید numpy برای برنامه خود ، برای مثال ، شما نوع:

ها

uv run --with numpy myfile.py

اگر نیاز به اضافه کردن وابستگی های متعدد دارید ، فقط آنها را با کاما جدا کنید:

uv run --with numpy,matplotlib myfile.py

همچنین می توانید نسخه های خاص را با استفاده از نحو موجود در جای دیگر در پایتون پین کنید:

uv run --with numpy==2.0 myfile.py

چه اتفاقی در زیر کاپوت می افتد؟

هنگامی که UV Run را با استفاده از -با ، UV با PYPI تماس می گیرید و سعی می کند در صورت تهیه یکی از آنها را بارگیری کنید و نسخه مناسب را بارگیری کنید. اگر شرط به عنوان چرخ ارائه شود ، از آن استفاده می کند. اگر اینطور نیست ، منبع را بدست می آورد و سعی می کند آن را برای بستر فعلی خود کامپایل کنید.

بعد ، UV بارگیری حاصل در فهرست موجود در نمایه کاربر خود را ذخیره می کند. پس از آن ، برنامه ای که شما انتخاب کردید با نیازهای بارگیری شده اجرا می شود.

اولین بار UV نیاز به PYPI را واگذار می کند ، بازخورد در مورد فرآیند بارگیری در کنسول را مشاهده خواهید کرد. بسته به میزان نیازهای موجود و چقدر آنها بزرگ هستند ، این ممکن است مدتی طول بکشد. اما در اجرای بعدی ، اگر همان الزامات را بخواهید ، آنها از حافظه نهان محلی به دست می آیند ، و بنابراین تقریباً فوراً شروع می شوند.

صحبت از ذخیره سازی ، UV به طور خودکار حافظه نهان بسته خود را مدیریت می کند ، اما اگر می خواهید آن را مجبور کنید ، می توانید از دستور UV Cache Clean استفاده کنید. اگر می خواهید از استفاده از حافظه نهان محلی (بدون نیاز به تمیز کردن آن) خودداری کنید ، می توانید از پرچم -n استفاده کنید: UV run -n -با ... .

با استفاده از “UV Run” در بسته ای با منبع محلی

اگر منبع بسته ای را به صورت محلی با یک فایل pyproject.toml در آن موجود دارید – مانند یک کلون یک مخزن GIT – می توانید از UV Run نیز استفاده کنید.

In the root directory of the package—where the pyproject.toml file lives—type uv run and then either the name of a package to execute from the project, or the name of an entry point for the بسته.

به عنوان مثال ، اگر این پروژه proj نامگذاری شده بود ، و ماژول ای به نام cmd برای باز کردن یک کنسول تعاملی برای پروژه داشت ، نوع:

uv run -m proj.cmd

اگر پروژه دارای یک نقطه ورود خط فرمان به نام proj_cmd بود ، شما تایپ می کنید:

uv run proj_cmd

اگر فقط uv_run را تایپ کنید ، UV سعی خواهد کرد تعیین کند که دستورات نقطه ورود (نه ماژول ها) برای پروژه فعلی در دسترس هستند.

همچنین می توانید با استفاده از تایپ کردن ، UV Python را اجرا کنید. سپس می توانید این دستور را با هر تعداد سوئیچ یا گزینه های اضافی که معمولاً به پایتون منتقل می کنید ، تکمیل کنید. به عنوان مثال ، دستور UV python -m proj.cmd همان اثر را با uv run -m proj.cmd خواهد داشت.