روش نصب پایتون روی یک مک

پایتون محبوب ترین زبان اول برای برنامه نویسان است روی یک مک

تا همین اواخر، فقدان ابزار توسعه استاندارد زبان، به علاوه ابزارهای توسعه اختیاری-اما ضروری رقابتی، به معنای شروعی دشوار برای مبتدیان پایتون بود.

برای رفع سردرگمی، یک رویکرد به روز برای نصب پایتون و راه اندازی یک پروژه برنامه نویسی با استفاده از یک ابزار واحد به نام Rye برای نصب نسخه های پایتون و کتابخانه های نرم افزاری به شما نشان خواهم داد.

Rye یک ابزار مدیریت پروژه همه‌جانبه برای پایتون است که به زبان Rust (برای سرعت) نوشته شده و از Cargo، مدیر بسته جامع Rust، از آرمین روناچر، خالق چارچوب وب پایتون، الهام گرفته شده است. این برای مبتدیان ایده آل است، با قرض گرفتن یک رویکرد مبتنی بر پوشه برای توسعه از زبان های دیگر مانند جاوا اسکریپت و Ruby.

فهرست

شما می خواهید URL این راهنما را برای مراجعات بعدی ذخیره کنید. آنچه در اینجا پوشش داده شده است:

• قبل از شروع
• نصب پایتون با چاودار
  – وجود پایتون را بررسی کنید
  – چاودار را نصب کنید
  – PATH را برای چاودار تنظیم کنید
  – نصب چاودار را تأیید کنید
  – تأیید نصب پایتون
• مدیریت نسخه و بسته با چاودار
  – یک پروژه با Rye ایجاد کنید
  – یک نسخه تنظیم کنید
  – اضافه کردن بسته ها
  – همگام سازی برای راه اندازی پروژه
  – پایتون را اجرا کنید
• گردش کار پایتون با چاودار
• نتیجه

قبل از شروع

شما نیاز دارید terminal برنامه، چه Mac Terminal یا یک جایگزین مانند Warp Terminal (ابزاری که من می نامم، “سریعترین راه برای تبدیل شدن به command-line کاربر حرفه ای”).

قبل از شروع، بررسی کنید که آیا نیاز به آپدیت macOS دارید یا خیر.

شاید شنیده باشید که پایتون از قبل نصب شده است روی مک شما مک های قدیمی (قبل از macOS 12.3) با Python 2.7 عرضه شدند. این یک نسخه قدیمی تر است، نه پایتون 3 که شما نیاز دارید. مک های جدیدتر با پایتون از پیش نصب شده عرضه نمی شوند.

قبل از شروع برنامه نویسی باید Xcode Command Line Tools را نصب کنید روی یک مک قبل از ادامه کار، باید بررسی کنید که آیا Xcode Command Line Tools نصب شده است یا خیر. هنگامی که Xcode Command Line Tools را نصب می کنید، اپل شامل Python 3.9.6 می شود. ممکن است وسوسه شوید که از آن استفاده کنید، اما این یک نسخه قدیمی است که فقط برای نرم افزار سیستم در نظر گرفته شده است، به همین دلیل است که باید نسخه جدیدی از Python را نصب کنید، همانطور که در اینجا نشان داده شده است.

نصب پایتون با چاودار

راه های مختلفی برای راه اندازی مک پایتون وجود دارد. در اینجا گزینه های شما، به طور خلاصه، با یک نقد وجود دارد.

در وب سایت Python.org، یک برنامه نصب کننده برای آخرین نسخه پایتون وجود دارد. اکثر توسعه دهندگان پایتون از استفاده از آن اجتناب می کنند زیرا مک را به روش هایی که مدیریت آن دشوار است به هم می ریزد.

اگر Homebrew را برای توسعه نرم‌افزار نصب می‌کنید، نصب آن آسان است pythonبا این حال، Python نصب شده توسط Homebrew برای مدیریت چندین پروژه Python مناسب نیست و توسعه می تواند دست و پا گیر باشد.

برخی از آموزش‌ها نصب Pyenv، یک مدیر نسخه پایتون را پیشنهاد می‌کنند. Pyenv انتخاب خوبی برای مدیریت چندین نسخه پایتون است، اما نیاز به آشنایی با Pip، یک مدیر بسته، و Venv یا Virtualenv، مدیران محیطی دارد. ابزارهای متعدد توسعه را پیچیده تر می کند.

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

پایتون را بررسی کنید

بهتر است بدون نسخه قبلی پایتون نصب شده شروع کنید، به جز نسخه پایتون که توسط Xcode Command Line Tools نصب شده است.

تلاش کردن python3 --version و which -a python3 برای بررسی اینکه آیا پایتون با ابزارهای خط فرمان Xcode نصب شده است یا خیر:

$ python3 --version
Python 3.9.6
$ which -a python3
/usr/bin/python3

شما از پایتون نصب شده توسط Xcode Command Line Tools استفاده نخواهید کرد، اما مهم است که بدانید Xcode Command Line Tools از قبل وجود دارد. در غیر این صورت، Xcode Command Line Tools را نصب کنید.

بررسی کنید که آیا نسخه دیگری از پایتون قبلاً نصب شده است یا خیر:

$ python --version
zsh: command not found: python

خواهی دید zsh: command not found: python اگر پایتون در دسترس نباشد من در جای دیگری در مورد روش به روز رسانی پایتون در صورتی که فکر می کنید از قبل پایتون دارید و همچنین راهنمای حل خطای “command not found” نوشته ام: pythonاگر مطمئن هستید پایتون نصب شده است اما در دسترس نیست.

اگر بیش از یک نسخه از پایتون را نصب کرده اید، مشکلی نیست زیرا پس از نصب Rye، مسیر Mac را تنظیم می کنید تا نسخه صحیح پایتون در دسترس باشد.

Rye را نصب کنید

Homebrew مورد نیاز نیست. Rye یک اسکریپت خود نصب دارد، بنابراین می توانید Rye را با a نصب کنید curl فرمان

$ curl -sSf https://rye-up.com/get | bash

کرل یک است command-line ابزاری که درخواست های HTTP را از terminal، برای کارهایی مانند دانلود و اجرای اسکریپت های نصب مفید است.

$ curl -sSf https://rye-up.com/get | bash
This script will automatically download and install rye (latest) for you.
####################################################################### 100.0%
Welcome to Rye!

This installer will install rye to /Users/username/.rye
This path can be changed by exporting the RYE_HOME environment variable.

Details:
  Rye Version: 0.26.0
  Platform: macos (aarch64)

? Continue? (y/n)

وارد y ادامه. Rye برای سفارشی کردن نصب سؤالاتی می پرسد.

? Select the preferred package installer ›
❯ uv (fast, recommended)
  pip-tools (slow, higher compatibility)

به طور پیش فرض، چاودار ارائه می دهد uv، یک نصب کننده بسته سریعتر و جدیدتر. من انتخاب را توصیه می کنم pip-tools برای سازگاری اگر مبتدی هستید، دنبال کردن آموزش هایی که به آنها اشاره می کنند آسان تر خواهد بود pip. انتخاب کنید pip-tools با کلیدهای جهت دار

در مرحله بعد، خود نصب‌کننده می‌پرسد از کدام نسخه پایتون به‌عنوان پیش‌فرض استفاده می‌کنید و نسخه نصب‌شده Rye یا نسخه‌های نصب‌شده قبلی را ارائه می‌دهد.

? What should running `python` or `python3` do when you are not inside a Rye managed project? ›
❯ Run a Python installed and managed by Rye
  Run the old default Python (provided by your OS, pyenv, etc.)

بهتر است از نسخه نصب شده Rye استفاده کنید. پیش فرض را بپذیرید Run a Python installed and managed by Rye با فشار دادن “Enter”. سپس خود نصب کننده می پرسد کدام نسخه پایتون را به عنوان پیش فرض نصب کند.

? Which version of Python should be used as default toolchain? (cpython@3.12) ›

پیش فرض را بپذیرید و Rye آخرین نسخه پایتون را نصب خواهد کرد. نصب با فشار دادن “Enter” شروع می شود.

Installed binary to /Users/username/.rye/shims/rye
Bootstrapping rye internals
Downloading cpython@3.12.1
Checking checksum
Unpacking
Downloaded cpython@3.12.1
Updated self-python installation at /Users/username/.rye/self

The rye directory /Users/username/.rye/shims was not detected روی PATH.
It is highly recommended that you add it.
? Should the installer add Rye to PATH via .profile? (y/n) ›

توجه داشته باشید که Rye فایل های پایتون خود را در آن نصب می کند ~/.rye/shims/rye.

چاودار پیشنهاد می دهد تا تنظیم شود $PATH برای ارجحیت به نسخه پایتون آن با تغییر دادن .profile فایل.

استفاده از .profile فایل یک قرارداد لینوکس است. در مک، ترجیح داده می شود که تنظیم شود $PATH که در .zprofile یا .zshrc فایل ها ترجیحا .zprofile. وارد n برای رد شدن از این مرحله خودکار. بعداً، شما را تنظیم خواهید کرد $PATH به صورت دستی

✔ Should the installer add Rye to PATH via .profile? · no
note: did not manipulate the path. To make it work, add this to your .profile manually:

    source "$HOME/.rye/env"

To make it work with zsh, you might need to add this to your .zprofile:

    source "$HOME/.rye/env"

For more information read https://rye-up.com/guide/installation/

All done!

Rye روش تکمیل نصب را به صورت دستی با ویرایش توضیح می دهد .zprofile فایل. من به شما نشان خواهم داد که چگونه این کار را انجام دهید.

PATH را برای چاودار تنظیم کنید

یک فینال هست مهم مرحله قبل از اینکه چاودار به درستی کار کند. باید مسیر Mac را تنظیم کنید تا مطمئن شوید که Rye نسخه صحیح پایتون را پیدا می کند. در غیر این صورت، دستور را وارد کنید python باعث خواهد شد zsh: command not found: python و فرمان python3 به نسخه قدیمی پایتون نصب شده با Xcode دسترسی خواهد داشت.

را ویرایش کنید ~/.zprofile فایل. را ~/.zprofile فایل برای تنظیم استفاده می شود $PATH. به طور متناوب، شما می توانید تغییر دهید ~/.zshrc فایل (برای توضیح تفاوت‌ها به فایل‌های پیکربندی Zsh چگونه کار می‌کنند؟ مراجعه کنید). می‌توانید از TextEdit، ویرایشگر متن گرافیکی پیش‌فرض macOS، برای باز کردن یک فایل از آن استفاده کنید terminal:

$ open -e ~/.zprofile

همچنین می توانید از ویرایشگرهای خط فرمان استفاده کنید nano یا vim برای ویرایش فایل های پیکربندی پوسته برای اطلاعات بیشتر در مورد ویرایش فایل های پیکربندی پوسته، به پیکربندی پوسته Zsh مراجعه کنید.

این دستور را به عنوان آخرین خط فایل پیکربندی خود برای پیکربندی پوسته Z برای Rye اضافه کنید:

source "$HOME/.rye/env"

وقتی شما terminal جلسه شروع می شود، پوسته Z اجرا خواهد شد ~/.rye/env اسکریپت برای تنظیم shims برای رهگیری و تغییر مسیر هر دستور پایتون. شما به نقل قول های دوگانه نیاز دارید زیرا دستور حاوی کاراکترهای ویژه است.

چاودار به شما می افزاید $PATH به طوری که دستور را اجرا کنید python یا python3 نسخه پایتون نصب شده توسط Rye را اجرا خواهد کرد.

تغییرات در ~/.zprofile تا زمانی که آن را ترک نکرده و مجدداً راه اندازی نکنید، فایل در ترمینال اعمال نمی شود terminal. از طرف دیگر (این ساده تر است)، می توانید از آن استفاده کنید source دستور ریست کردن محیط پوسته:

$ source ~/.zprofile

را source دستور یک فایل اسکریپت پوسته را می خواند و اجرا می کند، در این مورد محیط پوسته را با جدید خود بازنشانی می کند. $PATH تنظیمات.

پس از تنظیم مجدد پوسته، می توانید آن را بررسی کنید $PATH تنظیمات.

$ echo $PATH
/Users/username/.rye/shims:/opt/homebrew/bin:/opt/homebrew/sbin:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/System/Cryptexes/App/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin

را ~/.rye/shims دایرکتوری باید در سمت چپ باشد و بر سایر دایرکتوری ها اولویت داشته باشد.

نصب Rye را تأیید کنید

پس از نصب چاودار، استفاده کنید rye --version برای بررسی نصب بودن آن

$ rye --version
rye 0.26.0
commit: 0.26.0 (d245f625e 1403-02-23)
platform: macos (aarch64)
self-python: cpython@3.12
symlink support: true
uv enabled: false

تایید نصب پایتون

بررسی کنید که پایتون در دسترس است:

$ python --version
Python 3.12.1

آری شما پایتون را نصب کرده اید. اگر می بینید zsh: command not found: python، بررسی کنید که Mac PATH به درستی تنظیم شده باشد.

را python3 دستور باید نسخه نصب شده توسط Rye را به شما بدهد، نه نسخه نصب شده با Xcode.

$ python3 --version
Python 3.12.1

را which هنگامی که می‌خواهید ببینید پایتون کجا نصب شده است، فرمان دایرکتوری Rye shims را نشان می‌دهد. به خاطر داشته باشید که شما تنظیم کرده اید ~/.zprofile فایل برای استفاده از Rye shims برای رهگیری python نسخه های نصب شده توسط Rye را فرمان داده و تحویل دهید.

$ which python
/Users/username/.rye/shims/python

شما پایتون را با Rye با موفقیت نصب کردید.

مدیریت نسخه و بسته با چاودار

می توانید از چاودار برای موارد زیر استفاده کنید:

1. یک پروژه پایتون راه اندازی کنید.
2. یک نسخه پایتون خاص را برای یک پروژه نصب کنید.
3. بسته های پایتون را برای پروژه نصب کنید.

زبان‌های دیگر رویکردی مبتنی بر پروژه برای مدیریت بسته‌ها اتخاذ می‌کنند (مثلاً Rust’s Cargo، Ruby’s Bundler و npm جاوا اسکریپت). پایتون در اتخاذ این رویکرد کند بوده است، اما Rye در حال تغییر آن است و نیاز به ابزارهای جداگانه مانند Pyenv، Pip و Venv برای مدیریت نسخه‌ها، کتابخانه‌های نرم‌افزار و محیط‌ها را از بین می‌برد.

با Rye، با ایجاد یک پروژه جدید و انتخاب نسخه پایتون شروع می‌کنید. سپس می توانید بسته هایی را برای آن پروژه نصب کنید. Rye نسخه و بسته های پایتون را برای شما مدیریت خواهد کرد.

یک پروژه با Rye ایجاد کنید

یک پوشه برای پروژه پایتون بسازید. سپس دایرکتوری ها را به پروژه تغییر دهید root:

$ mkdir myproject
$ cd myproject

یک نسخه پایتون برای پروژه خود مشخص کنید:

$ rye pin 3
pinned 3.12.1 in /Users/username/workspace/myproject/.python-version

دستور rye pin 3 الف ایجاد خواهد کرد .python-version فایلی که جدیدترین نسخه پایتون را برای پروژه شما مشخص می کند.

شما باید دستور را اجرا کنید rye init برای ایجاد یک pyproject.toml فایل در پروژه شما root فهرست راهنما. این یک فایل پیکربندی خاص پروژه است که رای برای مدیریت نسخه ها و بسته های پایتون استفاده می کند.

$ rye init
success: Initialized project in /Users/username/workspace/myproject/.
Run `rye sync` to get started

اکنون می توانید نسخه پایتون را دریافت کرده و بسته ها را نصب کنید.

یک نسخه تنظیم کنید

Rye می تواند بین نسخه های مختلف پایتون نصب و جابجا شود.

Rye برای اشاره به نسخه های نصب شده پایتون از اصطلاح “Toolchains” استفاده می کند. برای نصب نسخه پایتون، می‌توانید با استفاده از Rye، یک زنجیره ابزار واکشی کنید.

$ rye fetch
$

اگر پایتون پیش فرض را با آن مشخص کرده باشید rye pin، rye fetch هیچ کاری نمی کند اگر نسخه پایتون دیگری را مشخص کرده اید، rye fetch نسخه مشخص شده را نصب خواهد کرد.

$ rye fetch
Downloading cpython@3.12.1
Checking checksum
success: Downloaded cpython@3.12.1

به‌طور پیش‌فرض، Rye همه فایل‌های اجرایی پایتون را در پوشه‌ای مخفی در فهرست اصلی کاربر نصب می‌کند. ~/.rye/py/. چاودار در مک می‌چرخد $PATH نسخه پایتون صحیحی را که در فهرست پروژه خود مشخص کرده اید انتخاب می کند،

بسته ها را اضافه کنید

مدیران بسته به شما امکان دانلود، نصب و به روز رسانی کتابخانه های نرم افزار و وابستگی های آنها را می دهند. اکثر بسته ها بستگی دارند روی سایر کتابخانه‌های نرم‌افزار خارجی – مدیر بسته هر وابستگی مورد نیاز آن بسته را واکشی و نصب می‌کند.

توسعه دهندگان باتجربه پایتون با Pip، مدیر بسته استاندارد پایتون، که با هر نسخه از پایتون از زمان پایتون 3.3 همراه است، آشنا هستند.

دستور pip install بسته‌ها را به صورت جهانی در یک سیستم پایتون یا نسخه‌های پایتون مشترک نصب می‌کند و درگیری‌های احتمالی ایجاد می‌کند.

برای نصب ایمن بسته های پایتون برای یک پروژه خاص با pip، باید از یک مدیر محیط پایتون مانند Venv برای ایجاد و فعال کردن یک محیط مجازی برای جلوگیری از تضادهای وابستگی استفاده کنید.

هنگامی که از چاودار به عنوان یک ابزار همه کاره استفاده می کنید، نیازی به آن نخواهید داشت venv برای مدیریت محیط، نصب بسته ها به طور مستقیم با Rye.

قبل از اینکه بخواهید یک بسته را با Rye نصب کنید، مطمئن شوید که a ایجاد کرده اید pyproject.toml فایل در پروژه شما root دایرکتوری با rye init.

شما می توانید هر بسته پایتون را از فهرست بسته پایتون نصب کنید. در اینجا ما ابزار cowsay را نصب می کنیم.

$ rye add cowsay
Added cowsay>=6.1 as regular dependency

اگر می بینید error: did not find pyproject.toml، باید بدوید rye init.

برای راه اندازی پروژه همگام سازی کنید

قبل از اینکه بتوانید از یک بسته در پروژه Rye استفاده کنید، باید اجرا کنید rye sync برای به روز رسانی فایل های قفل و نصب وابستگی ها در محیط مجازی.

$ rye sync
Initializing new virtualenv in /Users/username/workspace/python/myproject/.venv
Python version: cpython@3.12.3
Generating production lockfile: /Users/username/workspace/python/myproject/requirements.lock
Creating virtualenv for pip-tools
Generating dev lockfile: /Users/username/workspace/python/myproject/requirements-dev.lock
Installing dependencies
Looking in indexes: https://pypi.org/simple/
Obtaining file:///. (from -r /var/folders/ls/g23m524x5jbg401p12rctz7m0000gn/T/tmp06o05xiq (line 2))
  Installing build dependencies ... done
  Checking if build backend supports build_editable ... done
  Getting requirements to build editable ... done
  Installing backend dependencies ... done
  Preparing editable metadata (pyproject.toml) ... done
Collecting cowsay==6.1 (from -r /var/folders/ls/g23m524x5jbg401p12rctz7m0000gn/T/tmp06o05xiq (line 1))
  Using cached cowsay-6.1-py3-none-any.whl.metadata (5.6 kB)
Using cached cowsay-6.1-py3-none-any.whl (25 kB)
Building wheels for collected packages: myproject
  Building editable for myproject (pyproject.toml) ... done
  Created wheel for myproject: filename=myproject-0.1.0-py3-none-any.whl size=1074 sha256=0b34a41cbb517a78e5b60593c75e93a37df0bf7958e8921be5f6f6e24a26b5d1
  Stored in directory: /private/var/folders/ls/g23m524x5jbg401p12rctz7m0000gn/T/pip-ephem-wheel-cache-m03jgkok/wheels/8b/19/c8/73a63a20645e0f1ed9aae9dd5d459f0f7ad2332bb27cba6c0f
Successfully built myproject
Installing collected packages: myproject, cowsay
Successfully installed cowsay-6.1 myproject-0.1.0
Done!

Rye تمام عملیات خود را نشان می دهد، اما لازم نیست تمام جزئیات را بخوانید.

پایتون را اجرا کنید

پس از نصب بسته و اجرا rye sync، می توانید از مفسر پایتون به صورت تعاملی استفاده کنید (حلقه REPL یا Read-Eval-Print).

$ python
Python 3.12.1 (main, Jan  7 1403, 23:31:12) [Clang 16.0.3 ] روی darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import cowsay
>>> cowsay.cow('Hello World')
___________
| Hello World |
  ===========
           \
            \
              ^__^
              (oo)\_______
              (__)\       )\/\
                  ||----w |
                  ||     ||
>>>

وارد quit() یا تایپ کنید Control + D برای خروج از مفسر پایتون

اکنون شما آماده توسعه هر پروژه پایتون با Rye هستید! برای کسب اطلاعات بیشتر می توانید راهنمای کاربر چاودار را بخوانید.

گردش کار پایتون با چاودار

همانطور که در پایتون کد می نویسید، می خواهید کتابخانه های نرم افزاری را به پروژه خود اضافه کنید. بیایید به یک مثال نگاه کنیم.

Requests یک کتابخانه HTTP است که احتمالاً در بسیاری از پروژه ها از آن استفاده خواهید کرد. اگر به درخواست ها مراجعه کنید page روی PyPI، دستورالعمل های نصب را مشاهده خواهید کرد:

$ python -m pip install requests

را python -m pip دستور کمی دست و پا گیر است و اگر از Pip استفاده می کنید، باید قبل از آن استفاده کنید python -m venv .venv (برای راه اندازی یک محیط مجازی) و source .venv/bin/activate (برای فعال سازی محیط مجازی).

با Rye، می توانید درخواست ها را به خود اضافه کنید pyproject.toml فایل.

$ rye add requests

سپس اجرا کنید rye sync برای نصب پکیج

$ rye sync

اکنون می‌توانید از کتابخانه Requests در پروژه پایتون خود استفاده کنید، از جمله آن import بیانیه.

یادت باشه وقتی میبینی pip install در یک آموزش، می توانید استفاده کنید rye add و rye sync در عوض، بدون دستورات اضافی برای یک محیط مجازی.

مبتدیان استفاده می کنند pip نصب اغلب با سردرد مواجه می شود با دستور یافت نشد: pip و خطا: محیط با مدیریت خارجی. چاودار این مشکلات را برطرف می کند.

نتیجه

این مقاله مبتنی است روی راهنمایی که جزئیات بیشتری در مورد روش نصب پایتون ارائه می دهد روی مک.

Rye مورد علاقه جدید برای نصب و مدیریت پایتون است زیرا یک سیستم بسته بندی و راه اندازی منسجم را ارائه می دهد و نیاز به ابزارهای جداگانه مانند Pyenv، Pip و Venv را برای مدیریت نسخه ها، کتابخانه های نرم افزار و محیط ها از بین می برد.

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