建置 Python 3開發環境

활용단어참조的版本

활용단어참조進入 3.x的時代也好幾年了,但至今 Python 2.7.x即便已經不再維護,它還是以某種殭屍的型態存活在各個陳年專案上,對一個沒有舊包袱的新專案來說,Python 3.x的 x就必須是在開立專案時要考慮的問題,在 활용단어참조的網站上有 Python 各版本目前的生命週期表 :
파이썬 버전
유지 보수 상태
최초 발표
지원 종료
3.10
오류 수정
2020-10-04
2026-10
3.9
오류 수정
2020-10-05
2025-10
3.8
안전
2019-10-14
2024-10
3.7
안전
2018-06-27
2023-06-27
3.6
안전
2016-12-23
2021-12-23
2.7
생명의 종결
2010-07-03
2020-01-01
可以看到從 Python 3.7起就維持一年跳一個次版號的頻率,並維持著五年的生命週期.
在確認過 활용단어참조本身的生命週期後,另外一個考慮的點是 Python 3.6~3.10之間是否有淘汰某些舊的語法、標準庫、功能,如果有的話那必須進一步考慮到新專案的依賴套件是不是有用到那些被淘汰的功能,幸好 Python 3.6~3.10主要都是增加新的功能或語法,不太有淘汰舊功能的問題,因此對於新成立的專案,採用較新的 Python 3.10看起來是個不太有風險的決定.
補充一個消息, 從 Python 3.9 的下一版起會淘汰設計給保留與 Python 2.7 相容的舊標準庫／函式／API .

Python 3開發環境

目前所有的 Linux發行版,內建的 활용단어참조版本各有不同,如果您的 Linux較新,已經是內建 Python 3的話那恭喜您本文對您是無用處的,本文完.
以常見的 Linux發行版來說,內建的 활용단어참조如下:
Linux發行版
활용단어참조版次
초급 운영체제 6 오딘
Python 3.8.10
아빠OS 20.04
Python 3.8.2
Linux Mint 20
Python 3.8.2
Ubuntu20.04 LTS
Python 3.8.2
Debian 11
Python 3.9.2
Rocky Linux 8.4
Python 3.9.2
AlmaLinux OS 8.5
Python 3.6.8
CentOS 8.4.2105
Python 3.9.2
上面的列表涵蓋了主要的桌面端與伺服器端的 Linux發行版,可以看到 2021年 10月才發布的 Python 3.10理所當然地尚未被納入.
如果是 마커스 몬트리內建的 활용단어참조版本分別是 2.7.18 和 3.8.9.
下面開始我們的 Python 3開發環境建置之旅.

多版本 활용단어참조管理

想要把 Python 3裝起來,當然不能簡單粗暴地把作業系統預載的 활용단어참조取代掉,這樣做會造成後續系統維護與更新上的許多問題.在這邊我們利用 피에른這個多版本 활용단어참조管理器來幫助我們安裝一個與系統預載 활용단어참조並行存在的 Python 3
피에른不僅能幫我們安裝多版本的 구렁이也提供了 활용단어참조版本切換與管理的能力,並且這些由 피에른管理的 활용단어참조版本彼此間都互相獨立,包括 활용단어참조之下的套件／模組也都是獨立的,這樣的好處就是讓一台電腦的開發環境可以既多元又單純,多元的是 활용단어참조版本,讓新舊專案都可以有適用的 활용단어참조版本;單純的是各版次 활용단어참조下的套件與模組,並不會受到別的版次的 활용단어참조所影響.
根據 피에른的要求,需要安裝編譯 활용단어참조所必須的其它系統套件,因為 피에른安裝 활용단어참조的機制是把指定版本的 활용단어참조源碼抓下來在自己的電腦內編譯,因此必須安裝那些編譯工具,才可以順利的編譯出 구렁이.
對 Debian/Elementary OS/Pop_OS/Linux Mint/Ubuntu等同一脈的 Linux發行版,需要安裝下列套件:

> sudo apt install --no-install-reocmmends \
make \
build-essential \
libssl-dev \
zlib1g-dev \
libbz2-dev \
libreadline-dev \
libsqlite3-dev \
curl \
llvm \
libncurses5-dev \
libncursesw5-dev  \
tk-dev \
liblzma-dev \
libxml2-dev \
libxmlsec1-dev

對 마커스需要先安裝 자제했어以及 명령줄 도구後安裝下列套件:

> brew install openssl readline sqlite3 xz zlib bzip2

如果是其它 Linux發行版或其它作業系統,請參考 피에른的文件〈 Suggested build environment 〉一節安裝所需系統套件.(像這樣的套件依賴關係就像粽子串一樣,一個牽一個,全部拉起來就是一大堆⋯⋯.)
上面的系統套件裝完後,終於可以裝 피에른了,Linux安裝 피에른有現成的安裝腳本可以使用:

> curl https://pyenv.run | bash

如果是 마커스則是利用 자제했어安裝 pyenv:

> brew install pyenv

然後把 피에른加入 껍데기的設定檔內,讓我們進入 껍데기時就先執行 pyenv init 的命令:

> echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n  eval "$(pyenv init -)"\nfi' >> ~/.zshrc

以及設定讓編譯 활용단어참조時取用 자제했어版的 키플리브和 bzip2函式庫:

> echo 'export PATH="/usr/local/opt/bzip2/bin:$PATH"' >> ~/.zshrc
> export LDFLAGS="-L/usr/local/opt/zlib/lib -L/usr/local/opt/bzip2/lib"
> export CPPFLAGS="-I/usr/local/opt/zlib/include -I/usr/local/opt/bzip3/include"

上面是以 Zsh為例,如果是其他 껍데기要自行類推修改,完整的 피에른安裝流程和注意事項最好還是看 pyenv 的文件 .
安裝完之後,如果 피에른有被正確的加進 $PATH 內,那麼執行 pyenv 應該可以看到如下的說明畫面:

pyenv 2.2.0-5-g54889eb
Usage: pyenv <command> [<args>]Some useful pyenv commands are:
   activate             Activate virtual environment
   commands             List all available pyenv commands
   deactivate           Deactivate virtual environment
   doctor               Verify pyenv installation and development tools to build pythons.
   exec                 Run an executable with the selected Python version
   global               Set or show the global Python version(s)
   help                 Display help for a command
   hooks                List hook scripts for a given pyenv command
   init                 Configure the shell environment for pyenv
   install              Install a Python version using python-build
   local                Set or show the local application-specific Python version(s)
   prefix               Display prefix for a Python version
   rehash               Rehash pyenv shims (run this after installing executables)
   root                 Display the root directory where versions and shims are kept
   shell                Set or show the shell-specific Python version
   shims                List existing pyenv shims
   uninstall            Uninstall a specific Python version
   version              Show the current Python version(s) and its origin
   --version            Display the version of pyenv
   version-file         Detect the file that sets the current pyenv version
   version-name         Show the current Python version
   version-origin       Explain how the current Python version is set
   versions             List all Python versions available to pyenv
   virtualenv           Create a Python virtualenv using the pyenv-virtualenv plugin
   virtualenv-delete    Uninstall a specific Python virtualenv
   virtualenv-init      Configure the shell environment for pyenv-virtualenv
   virtualenv-prefix    Display real_prefix for a Python virtualenv version
   virtualenvs          List all Python virtualenvs found in `$PYENV_ROOT/versions/*'.
   whence               List all Python versions that contain the given executable
   which                Display the full path to an executable

See `pyenv help <command>' for information on a specific command.
For full documentation, see: https://github.com/pyenv/pyenv#readme

在做後續的動作之前,建議先跑一下 피엔프 의사讓 피에른自己檢查前面提到的用於編譯的套件是不是都有裝好.

安裝 Python 3

在裝 Python 3之前,先看一下 피에른可以幫我們裝哪些個版本的 구렁이:

> pyenv install --list

Available versions:
...
2.7.18
...
3.9.7
3.10.0
...
activepython-3.6.0
...
anaconda3-2021.05
...
graalpython-21.3.0
...
micropython-1.15
...
miniconda3-4.7.12
...
pypy3.8-7.3.7
...
pyston-2.3.1
...
stackless-3.7.5

可以看到不只是標準的 CPython其他自行封裝的(이벤트 구렁이, 구렁이, 미니 구렁이)第三方的 활용단어참조解釋器(PyPy、Pyston、Stackless、MicroPython)也都可以由 피에른安裝與管理.
上面可以看到 Python 3最新的版號就是 3.10.0,勇敢的把它裝起來:

> pyenv install 3.10.0

經過一連串嘰哩呱啦的下載與編譯過程,最後應該會看到一段成功的訊息.
我們可以用 pyenv versions 來確認一下當前系統內存在的 활용단어참조有哪些:

> pyenv versions

* system
  3.10.0

如預期的,除了系統預帶的 활용단어참조外,多了一個 Python 3.10.0
系統預帶的 활용단어참조前面有個 * 號,表示現在是用它當作目前操作環境下的 구렁이目前我們還不用做切換,直到在 활용단어참조專案內才會在專案資料夾內定義專案的 활용단어참조版本,而這需要下一個工具 시가

활용단어참조專案的虛擬環境與套件管理

到上一節為止我們利用 피에른在系統內裝了 Python 3.10下面會示範在一個新專案內利用 시가這個工具來建立專案的 활용단어참조虛擬環境以及管理依賴的套件.
關於 활용단어참조的虛擬環境／套件管理工具,除了 시가外,還有其他的選擇,可以參考〈 Overview of python dependency management tools 〉一文了解它們之間的特性與差異.前面我們用的 피에른其實也具有管理虛擬環境的能力,但個人比較偏好把虛擬環境和套件管理器整合在一起的工具,피에른本身不具被依賴套件管理的能力,而同時具備虛擬環境管理與套件管理的工具,有 시가等.
接下來開始裝 시가
在安裝 시가前,因為 시가本身也是以 활용단어참조開發的,它也有它自己的依賴性問題,所以我們想把它裝在 Python 3.9的環境之下,因此我們先把 활용단어참조切換到 3.9的環境:

> pyenv global 3.10.0

雖然是要把 시가裝在 Python 3.9的環境內,但這並不影響後面 시가建立虛擬環境時要用到的 활용단어참조版本.
切換完可以用 pyenv versions 確認一下.
回到安裝 시가的主題,시가也有著傳便便的安裝腳本:

> curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python -

一樣一陣嘰哩呱啦的安裝完成後,預設會安裝在 ~/.시/內,首先要確保保 시가的主程式 ~/.시/쓰레기통/시有在 $PATH 內,有的話應該就可以執行 poetry 了:

Poetry version 1.1.11

USAGE
  poetry [-h] [-q] [-v [<...>]] [-V] [--ansi] [--no-ansi] [-n] <command> [<arg1>] ... [<argN>]

ARGUMENTS
  <command>              The command to execute
  <arg>                  The arguments of the command

GLOBAL OPTIONS
  -h (--help)            Display this help message
  -q (--quiet)           Do not output any message
  -v (--verbose)         Increase the verbosity of messages: "-v" for normal output, "-vv" for more verbose output and "-vvv" for debug
  -V (--version)         Display this application version
  --ansi                 Force ANSI output
  --no-ansi              Disable ANSI output
  -n (--no-interaction)  Do not ask any interactive question

AVAILABLE COMMANDS
  about                  Shows information about Poetry.
  add                    Adds a new dependency to pyproject.toml.
  build                  Builds a package, as a tarball and a wheel by default.
  cache                  Interact with Poetry's cache
  check                  Checks the validity of the pyproject.toml file.
  config                 Manages configuration settings.
  debug                  Debug various elements of Poetry.
  env                    Interact with Poetry's project environments.
  export                 Exports the lock file to alternative formats.
  help                   Display the manual of a command
  init                   Creates a basic pyproject.toml file in the current directory.
  install                Installs the project dependencies.
  lock                   Locks the project dependencies.
  new                    Creates a new Python project at <path>.
  publish                Publishes a package to a remote repository.
  remove                 Removes a package from the project dependencies.
  run                    Runs a command in the appropriate environment.
  search                 Searches for packages on remote repositories.
  self                   Interact with Poetry directly.
  shell                  Spawns a shell within the virtual environment.
  show                   Shows information about packages.
  update                 Update the dependencies as according to the pyproject.toml file.
  version                Shows the version of the project or bumps it when a valid bump rule is provided.

接下來我們開始拿一個專案 프로젝트 1在裡面建立專屬於它的 Python 3.10虛擬環境.
首先要指定這個專案要用的 활용단어참조版本:

> pyenv local 3.10.0

上面第一個指令用於指定這個 프로젝트 1資料夾要用的 활용단어참조版本,它會幫我們建立一個 .python 버전檔案,裡面只要寫上版次,피에른就會依照裡面指定的版次套用於這個資料夾內,後面我們也驗證了確實是用了 Python 3.10
接著建立專案的虛擬環境:

> poetry init

Package name [project1]:
...
Compatible Python versions [^3.10]:
...
Generated file
[tool.poetry]
...
[tool.poetry.dependencies]
python = "^3.10"
[tool.poetry.dev-dependencies]
...
[build-system]
...
Do you confirm generation? (yes/no) [yes]

poetry init 命令用於初始化這個 프로젝트 1專案,透過問答式的界面,最後會建立出 pyproject.톰檔案,裡面有專案的基本資料、相容的 활용단어참조版本、依賴的套件清單等等.
在建立完 pyproject.톰後,實際上也定義出了一個以 Python 3.10為基礎的虛擬環境,進去看看:

> poetry shell

Creating virtualenv ...
Spawning shell within ...
...

(project1-...) > python --version

Python 3.10.0

(project1-...) > pip list

Package    Version
---------- -------
pip        21.3.1
setuptools 57.4.0
wheel      0.35.1

經過短暫的嘰哩呱啦後我們進入了 프로젝트 1虛擬環境的 껍데기內,也驗證了 활용단어참조的版本及套件清單,相當的乾淨,至此我們得到了一個以 Python 3.10.0為基礎的乾淨的開發環境,並且它也獨立於其它的開發環境.

結語

這篇文章介紹了 활용단어참조的多版本管理以及專案虛擬環境從無到有的建立,主要是混合運用 피에른及 시가兩個工具,要注意的是兩者都有虛擬環境管理的能力,但我們偏好用 시가它同時能管理虛擬環境及專案的套件依賴性.這篇文章僅談到虛擬環境的建立為止,並未提及專案依賴套件的加入與管理,這部份會另外開一個主題來談.

來源: