توقف استفاده از pyenv

سادگی pyenv باعث می‌شود غیرفعال‌سازی موقت یا حذف کامل آن از سیستم آسان باشد. برای غیرفعال کردن مدیریت نسخه‌های پایتون توسط pyenv، کافی است خط pyenv init را از پیکربندی راه‌اندازی پوسته خود حذف کنید. این کار دایرکتوری شیم‌های pyenv را از PATH حذف می‌کند و فراخوانی‌های بعدی مانند python، همانند پیش از pyenv، نسخه پایتون سیستم را اجرا خواهند کرد.

دستور pyenv همچنان در خط فرمان در دسترس خواهد بود، اما برنامه‌های پایتون شما تحت تأثیر جابه‌جایی نسخه قرار نخواهند گرفت.

برخی از دستورهای مفید pyenv عبارتند از:

commands

فهرست کردن تمام دستورهای در دسترس pyenv

exec

اجرای یک فایل اجرایی با نسخه انتخاب‌شده پایتون

global

تنظیم یا نمایش نسخه(های) سراسری پایتون

help

نمایش راهنمای یک دستور

hooks

فهرست کردن اسکریپت‌های قلاب (hook) برای یک دستور معین pyenv

init

پیکربندی محیط پوسته برای pyenv

install

نصب یک نسخه پایتون با استفاده از python-build

local

تنظیم یا نمایش نسخه(های) محلی مختص به برنامه پایتون

prefix

نمایش پیشوند (prefix) برای یک نسخه پایتون

rehash

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

root

نمایش دایرکتوری ریشه که نسخه‌ها و شیم‌ها در آن نگهداری می‌شوند

shell

تنظیم یا نمایش نسخه پایتون مخصوص پوسته فعلی

shims

فهرست کردن شیم‌های موجود pyenv

uninstall

حذف نسخه‌های نصب‌شده پایتون

version

نمایش نسخه(های) فعلی پایتون و منشأ آن

version-file

تشخیص فایلی که نسخه فعلی pyenv را تعیین می‌کند

version-name

نمایش نسخه فعلی پایتون

version-origin

توضیح درباره نحوه تعیین نسخه فعلی پایتون

versions

فهرست کردن تمام نسخه‌های پایتون در دسترس pyenv

whence

فهرست کردن تمام نسخه‌های پایتونی که شامل فایل اجرایی داده‌شده هستند

which

نمایش مسیر کامل به یک فایل اجرایی

برای اطلاعات درباره یک دستور خاص، به `pyenv help <command>' مراجعه کنید. برای مستندات کامل، بخش COMMAND REFERENCE را ببینید..SH "گزینه‌ها (OPTIONS)"

-h, --help

نمایش خلاصه‌ای از گزینه‌ها.

-v, --version

نمایش نسخه برنامه.

آشنایی با PATH (Understanding PATH)

هنگامی که دستوری مانند python یا pip را اجرا می‌کنید، سیستم‌عامل شما فهرستی از دایرکتوری‌ها را برای یافتن یک فایل اجرایی با آن نام جستجو می‌کند. این فهرست دایرکتوری‌ها در یک متغیر محیطی به نام PATH قرار دارد که در آن هر دایرکتوری با یک دونقطه (:) از بقیه جدا شده است:

/usr/local/bin:/usr/bin:/bin

دایرکتوری‌ها در PATH از چپ به راست جستجو می‌شوند، بنابراین یک فایل اجرایی منطبق در دایرکتوری ابتدای فهرست، نسبت به دیگری در انتهای فهرست اولویت دارد. در این مثال، ابتدا دایرکتوری /usr/local/bin جستجو می‌شود، سپس /usr/bin و پس از آن /bin.

آشنایی با شیم‌ها (Understanding Shims)

ابزار pyenv با قرار دادن دایرکتوری حاوی شیم‌ها (shims) در ابتدای متغیر PATH شما کار می‌کند:

$(pyenv root)/shims:/usr/local/bin:/usr/bin:/bin

از طریق فرآیندی به نام بازسازی هش (rehashing)، ابزار pyenv شیم‌ها را در آن دایرکتوری نگهداری می‌کند تا با هر دستور Python (python، pip و غیره) در تمام نسخه‌های نصب‌شده Python مطابقت داشته باشند.

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

• متغیر PATH شما را برای یافتن یک فایل اجرایی به نام pip جستجو می‌کند
• شیم pyenv به نام pip را در ابتدای PATH شما پیدا می‌کند
• شیم به نام pip را اجرا می‌کند که به نوبه خود دستور را به pyenv منتقل می‌کند

انتخاب نسخه Python (Choosing the Python Version)

هنگامی که یک شیم را اجرا می‌کنید، pyenv با خواندن از منابع زیر و به همین ترتیب، تعیین می‌کند که از کدام نسخه Python استفاده شود:

1.

متغیر محیطی PYENV_VERSION (در صورت تعیین شدن). می‌توانید از دستور pyenv shell برای مقداردهی این متغیر محیطی در نشست شل فعلی خود استفاده کنید.

2.

فایل مختص برنامه .python-version در دایرکتوری جاری (در صورت وجود). می‌توانید فایل .python-version دایرکتوری جاری را با دستور pyenv local تغییر دهید.

3.

نخستین فایل .python-version یافت‌شده (در صورت وجود) از طریق جستجو در دایرکتوری‌های والد، تا رسیدن به ریشه فایل‌سیستم شما.

4.

فایل سراسری $(pyenv root)/version. می‌توانید این فایل را با دستور pyenv global تغییر دهید. اگر فایل نسخه سراسری وجود نداشته باشد، pyenv فرض می‌کند می‌خواهید از Python «سیستم» استفاده کنید. (به عبارت دیگر، هر نسخه‌ای که در صورت عدم وجود pyenv در PATH شما اجرا می‌شد.)

نکته: می‌توانید چندین نسخه را هم‌زمان فعال کنید، از جمله چندین نسخه از Python2 یا Python3 به طور هم‌زمان. این قابلیت امکان استفاده موازی از Python2 و Python3 را فراهم می‌کند و برای ابزارهایی مانند tox الزامی است. برای نمونه، برای تنظیم مسیر خود به طوری که ابتدا از Python و Python3 سیستم استفاده کند (در این مثال روی 2.7.9 و 3.4.2 تنظیم شده)، اما همچنین نسخه‌های 3.3.6، 3.2 و 2.5 پایتون را در PATH در دسترس داشته باشید، ابتدا باید نسخه‌های ناموجود را با pyenv install نصب کنید و سپس pyenv global system 3.3.6 3.2 2.5 را تنظیم نمایید. در این مرحله، باید بتوان با استفاده از pyenv which مسیر کامل اجرایی هر یک از این‌ها را پیدا کرد؛ به عنوان مثال pyenv which python2.5 (باید $(pyenv root)/versions/2.5/bin/python2.5 را نمایش دهد) یا pyenv which python3.4 (باید مسیر Python3 سیستم را نمایش دهد). شما همچنین می‌توانید چند نسخه را در یک فایل .python-version مشخص کنید که با خطوط جدید یا هر فاصله خالی از یکدیگر جدا شده باشند. hy

مکان‌یابی نسخه نصب‌شده Python (Locating the Python Installation)

به محض اینکه pyenv تعیین کند برنامه‌تان کدام نسخه Python را مشخص کرده است، دستور را به نسخه نصب‌شده مربوطه هدایت می‌کند.

هر نسخه Python در دایرکتوری اختصاصی خود در مسیر زیر نصب می‌شود:

$(pyenv root)/versions.

برای مثال، ممکن است این نسخه‌ها نصب شده باشند:

• $(pyenv root)/versions/2.7.8/
• $(pyenv root)/versions/3.4.2/
• $(pyenv root)/versions/pypy-2.4.0/

از دیدگاه pyenv، نام‌های نسخه‌ها صرفاً همان نام دایرکتوری‌ها در $(pyenv root)/versions هستند.

مدیریت محیط‌های مجازی (Managing Virtual Environments)

یک پلاگین pyenv به نام pyenv-virtualenv وجود دارد که قابلیت‌های گوناگونی را برای کمک به کاربران pyenv جهت مدیریت محیط‌های مجازی ایجادشده توسط virtualenv یا Anaconda به همراه دارد. از آنجا که اسکریپت activate در این محیط‌های مجازی متکی بر تغییر متغیر $PATH در شل تعاملی کاربر است، در قلاب‌های اجرای دستور به سبک شیم در pyenv تداخل ایجاد می‌کند. توصیه می‌کنیم چنانچه قصد استفاده از این محیط‌های مجازی را دارید، pyenv-virtualenv را نیز نصب کنید.

pyenv commands

فهرست کردن تمام دستورهای موجود pyenv..SS "pyenv local" با نوشتن نام نسخه در فایل .python-version در دایرکتوری جاری، یک نسخه محلی و مختص به برنامه از Python را تنظیم می‌کند. این نسخه بر نسخه سراسری اولویت دارد و خودش نیز می‌تواند با تنظیم متغیر محیطی PYENV_VERSION یا با دستور pyenv shell نادیده گرفته شود.

$ pyenv local 2.7.6

هنگام اجرا بدون شماره نسخه، pyenv local نسخه محلیِ در حال حاضر پیکربندی‌شده را گزارش می‌دهد. شما همچنین می‌توانید نسخه محلی را لغو کنید:

$ pyenv local --unset

نسخه‌های پیشین pyenv مشخصات نسخه محلی را در فایلی به نام .pyenv-version ذخیره می‌کردند. برای سازگاری با نسخه‌های پیشین، pyenv نسخه محلی مشخص‌شده در فایل .pyenv-version را می‌خواند، اما فایل .python-version در همان دایرکتوری اولویت بالاتری خواهد داشت.

می‌توانید چندین نسخه را به‌طور هم‌زمان به‌عنوان Python محلی مشخص کنید.

فرض کنید دو نسخه 2.7.6 و 3.3.3 را دارید. اگر 2.7.6 را به 3.3.3 ترجیح می‌دهید:

$ pyenv local 2.7.6 3.3.3
$ pyenv versions
  system
* 2.7.6 (set by /Users/yyuu/path/to/project/.python-version)
* 3.3.3 (set by /Users/yyuu/path/to/project/.python-version)
$ python --version
Python 2.7.6
$ python2.7 --version
Python 2.7.6
$ python3.3 --version
Python 3.3.3

یا اگر 3.3.3 را به 2.7.6 ترجیح می‌دهید:

$ pyenv local 3.3.3 2.7.6
$ pyenv versions
  system
* 2.7.6 (set by /Users/yyuu/path/to/project/.python-version)
* 3.3.3 (set by /Users/yyuu/path/to/project/.python-version)
  venv27
$ python --version
Python 3.3.3
$ python2.7 --version
Python 2.7.6
$ python3.3 --version
Python 3.3.3

pyenv global

با نوشتن نام نسخه در فایل ~/.pyenv/version، نسخه سراسری Python را برای استفاده در تمام پوسته‌ها تنظیم می‌کند. این نسخه می‌تواند توسط یک فایل .python-version مختص برنامه یا با تنظیم متغیر محیطی PYENV_VERSION نادیده گرفته شود.

$ pyenv global 2.7.6

نام نسخه ویژه system به pyenv می‌گوید که از Python سیستم (شناسایی‌شده با جستجو در $PATH شما) استفاده کند.

هنگام اجرا بدون شماره نسخه، pyenv global نسخه سراسریِ در حال حاضر پیکربندی‌شده را گزارش می‌دهد.

می‌توانید چندین نسخه را به‌طور هم‌زمان به‌عنوان Python سراسری مشخص کنید.

فرض کنید دو نسخه 2.7.6 و 3.3.3 را دارید. اگر 2.7.6 را به 3.3.3 ترجیح می‌دهید:

$ pyenv global 2.7.6 3.3.3
$ pyenv versions
  system
* 2.7.6 (set by /Users/yyuu/.pyenv/version)
* 3.3.3 (set by /Users/yyuu/.pyenv/version)
$ python --version
Python 2.7.6
$ python2.7 --version
Python 2.7.6
$ python3.3 --version
Python 3.3.3

یا اگر 3.3.3 را به 2.7.6 ترجیح می‌دهید:

$ pyenv global 3.3.3 2.7.6
$ pyenv versions
  system
* 2.7.6 (set by /Users/yyuu/.pyenv/version)
* 3.3.3 (set by /Users/yyuu/.pyenv/version)
  venv27
$ python --version
Python 3.3.3
$ python2.7 --version
Python 2.7.6
$ python3.3 --version
Python 3.3.3

pyenv shell

با تنظیم متغیر محیطی PYENV_VERSION در پوسته جاری شما، یک نسخه مختص به پوسته از Python را تنظیم می‌کند. این نسخه بر نسخه‌های مختص برنامه و نسخه سراسری اولویت دارد.

$ pyenv shell pypy-2.2.1

هنگام اجرا بدون شماره نسخه، pyenv shell مقدار فعلی PYENV_VERSION را گزارش می‌دهد. شما همچنین می‌توانید نسخه پوسته را لغو کنید:

$ pyenv shell --unset

توجه داشته باشید که برای استفاده از این دستور، باید یکپارچه‌سازی پوسته با pyenv فعال باشد (مرحله ۳ از دستورالعمل‌های نصب). اگر ترجیح می‌دهید از یکپارچه‌سازی پوسته استفاده نکنید، می‌توانید متغیر PYENV_VERSION را خودتان مقداردهی کنید:

$ export PYENV_VERSION=pypy-2.2.1

می‌توانید چندین نسخه را به‌طور هم‌زمان از طریق PYENV_VERSION مشخص کنید.

فرض کنید دو نسخه 2.7.6 و 3.3.3 را دارید. اگر 2.7.6 را به 3.3.3 ترجیح می‌دهید:

$ pyenv shell 2.7.6 3.3.3
$ pyenv versions
  system
* 2.7.6 (set by PYENV_VERSION environment variable)
* 3.3.3 (set by PYENV_VERSION environment variable)
$ python --version
Python 2.7.6
$ python2.7 --version
Python 2.7.6
$ python3.3 --version
Python 3.3.3

یا اگر 3.3.3 را به 2.7.6 ترجیح می‌دهید:

$ pyenv shell 3.3.3 2.7.6
$ pyenv versions
  system
* 2.7.6 (set by PYENV_VERSION environment variable)
* 3.3.3 (set by PYENV_VERSION environment variable)
  venv27
$ python --version
Python 3.3.3
$ python2.7 --version
Python 2.7.6
$ python3.3 --version
Python 3.3.3

نصب یک نسخه از Python

Usage: pyenv install [-f] [-kvp] <version>
       pyenv install [-f] [-kvp] <definition-file>
       pyenv install -l|--list
  -l, --list             فهرست کردن تمام نسخه‌های موجود
  -f, --force            نصب حتی در صورتی که به نظر برسد نسخه از قبل
  					نصب شده است
  -s, --skip-existing    رد کردن نصب در صورتی که به نظر برسد نسخه
  					از قبل نصب شده است
  گزینه‌های python-build:
  -k, --keep        نگه‌داشتن درخت مبدأ در $PYENV_BUILD_ROOT پس از نصب
                    (پیش‌فرض: $PYENV_ROOT/sources)
  -v, --verbose     حالت پرگو: چاپ وضعیت کامپایل در stdout
  -p, --patch       اعمال یک وصله از stdin پیش از ساخت
  -g, --debug       ساخت یک نسخه اشکال‌زدایی (debug)

برای مشاهده فهرست تمام نسخه‌های موجود Python، از جمله Anaconda، Jython، pypy و stackless، از این دستور استفاده کنید:

$ pyenv install --list

سپس نسخه‌های مورد نظر را نصب کنید:

$ pyenv install 2.7.6
$ pyenv install 2.6.8
$ pyenv versions
  system
  2.6.8
* 2.7.6 (set by /home/yyuu/.pyenv/version)

pyenv uninstall

حذف نسخه‌های Python.

Usage: pyenv uninstall [-f|--force] <version> ...
   -f  تلاش برای حذف نسخه مشخص‌شده بدون درخواست تأیید.
       اگر نسخه وجود نداشته باشد، هیچ پیام خطایی
       نمایش داده نمی‌شود.

pyenv rehash

شیم‌ها (shims) را برای تمام فایل‌های اجرایی Python که برای pyenv شناخته‌شده هستند (یعنی ~/.pyenv/versions/*/bin/*) نصب می‌کند. این دستور را پس از نصب یک نسخه جدید از Python یا پس از نصب بسته‌ای که فایل‌های اجرایی ارائه می‌دهد اجرا کنید.

$ pyenv rehash

pyenv version

نسخه فعال فعلی Python را به همراه اطلاعاتی درباره نحوه تنظیم آن نمایش می‌دهد.

$ pyenv version
2.7.6 (set by /home/yyuu/.pyenv/version)

pyenv versions

تمام نسخه‌های Python شناخته‌شده برای pyenv را فهرست می‌کند و یک علامت ستاره در کنار نسخه فعال فعلی نمایش می‌دهد.

$ pyenv versions
  2.5.6
  2.6.8
* 2.7.6 (set by /home/yyuu/.pyenv/version)
  3.3.3
  jython-2.5.3
  pypy-2.2.1

pyenv which

مسیر کامل فایل اجرایی را که pyenv هنگام اجرای دستور داده‌شده فراخوانی می‌کند، نمایش می‌دهد.

$ pyenv which python3.3
/home/yyuu/.pyenv/versions/3.3.3/bin/python3.3

pyenv whence

تمام نسخه‌های Python را که دستور داده‌شده در آن‌ها نصب است، فهرست می‌کند.

$ pyenv whence 2to3
2.6.8
2.7.6
3.3.3