12. Sanal Ortamlar ve Paketler

12.1. Tanıtım

Python uygulamaları genellikle standart kütüphanenin bir parçası olmayan paketleri ve modülleri kullanır. Uygulama bazen kütüphanenin spesifik bir sürümüne ihtiyaç duyar, çünkü uygulama belirli bir hatanın düzeltilmiş olmasını veya uygulamanın kütüphanenin arabiriminin eski bir sürümü kullanılarak yazılmasını gerektirebilir.

Bu, bir Python yüklemesinin, her uygulamanın gereksinimlerini karşılamasının mümkün olmayabileceği anlamına gelir. Bir A uygulaması belirli bir modülün 1.0 sürümüne, bir B uygulaması ise 2.0 sürümüne ihtiyaç duyuyorsa, sürümlerin farklı olmasından dolayı versiyon 1.0 veya 2.0’ı yüklemek A veya B uygulamasından birini çalışmaz hale getirecektir.

Bu sorunun çözümü, spesifik bir Python sürümü için Python yüklemesi ve bir dizi ek paket içeren bağımsız bir dizin ağacı olan virtual environment (sanal ortam) oluşturmaktır.

Bu sayede farklı uygulamalar farklı sanal ortamlar kullanabilir. Çakışan gereksinimlerin önceki örneğini çözmek için, A uygulamasının sanal ortamında sürüm 1.0 yüklüyken, B uygulamasının sanal ortamında sürüm 2.0 yüklü olabilir. B uygulaması bir kitaplığın sürüm 3.0’a yükseltilmesini gerektiriyorsa, bu uygulama A’nın ortamını etkilemez.

12.2. Sanal Ortamlar Oluşturma

The module used to create and manage virtual environments is called venv. venv will install the Python version from which the command was run (as reported by the --version option). For instance, executing the command with python3.12 will install version 3.12.

Sanal ortam oluşturmak için, yerleştirmek istediğiniz dizine karar verin ve venv modülünü dizin yolu ile bir komut dosyası olarak çalıştırın:

python -m venv tutorial-env

Bu, eğer yoksa tutorial-env dizinini oluşturur ve ayrıca Python derleyicisinin bir kopyasını ve çeşitli destekleyici dosyaları içeren dizinler oluşturur.

Sanal ortam için ortak bir dizin konumu .venv ‘dir. Bu ad, dizini genellikle kabuğunuzda gizli tutar ve böylece dizinin neden var olduğunu açıklayan bir ad verirken aradan uzak tutar. Ayrıca, bazı araç çalıştırmanın desteklediği .env ortam değişkeni tanım dosyalarıyla çakışmayı önler.

Sanal bir ortam oluşturduktan sonra onu etkinleştirebilirsiniz.

Windows’da çalıştır:

tutorial-env\Scripts\activate

Unix veya MacOS’ta çalıştır:

source tutorial-env/bin/activate

(Bu komut dosyası bash kabuğu için yazılmıştır. Eğer csh veya fish kabuklarını kullanıyorsanız, bunun yerine activate.csh veya activate.fish komut dosyalarını kullanmanız gerekmektedir.)

Sanal ortamı etkinleştirmek, hangi sanal ortamı kullandığınızı göstermek için kabuğunuzun görünüşünü değiştirir ve ortamı değiştirerek python komutunun belirlediğiniz spesifik Python kurulumunu ve sürümünü çalıştırmasını sağlar. Mesela:

$ source ~/envs/tutorial-env/bin/activate
(tutorial-env) $ python
Python 3.5.1 (default, May  6 2016, 10:59:36)
  ...
>>> import sys
>>> sys.path
['', '/usr/local/lib/python35.zip', ...,
'~/envs/tutorial-env/lib/python3.5/site-packages']
>>>

Bir sanal ortamı devre dışı bırakmak için şunu yazın:

deactivate

terminalin içine.

12.3. Paketleri pip ile Yönetme

pip adlı bir program kullanarak paketleri yükleyebilir, yükseltebilir ve kaldırabilirsiniz. Varsayılan olarak pip, Python Paket Dizini ‘nden paketler yükler. Python Paket Dizini’ne web tarayıcınızdan giderek göz atabilirsiniz.

pip bir dizi alt komut içerir: “install” (yükle), “uninstall” (kaldır), “freeze” (dondur), vb. (pip için eksiksiz dokümantasyon için Python Modüllerini Kurmak rehberine bakın.)

Paketin adını belirterek paketin en son sürümünü yükleyebilirsiniz:

(tutorial-env) $ python -m pip install novas
Collecting novas
  Downloading novas-3.1.1.3.tar.gz (136kB)
Installing collected packages: novas
  Running setup.py install for novas
Successfully installed novas-3.1.1.3

Paketin belirli bir sürümünü, paket adını ve ardından == ve sürüm numarasını vererek de yükleyebilirsiniz:

(tutorial-env) $ python -m pip install requests==2.6.0
Collecting requests==2.6.0
  Using cached requests-2.6.0-py2.py3-none-any.whl
Installing collected packages: requests
Successfully installed requests-2.6.0

Bu komutu tekrar çalıştırırsanız, pip istenen sürümün kurulu olduğunu fark edecek ve hiçbir şey yapmayacaktır. Bu sürümü almak için farklı bir sürüm numarası sağlayabilir veya paketi en son sürüme yükseltmek için python -m pip install --upgrade komutunu çalıştırabilirsiniz:

(tutorial-env) $ python -m pip install --upgrade requests
Collecting requests
Installing collected packages: requests
  Found existing installation: requests 2.6.0
    Uninstalling requests-2.6.0:
      Successfully uninstalled requests-2.6.0
Successfully installed requests-2.7.0

python -m pip uninstall ve ardından gelen bir veya daha fazla paket adı, paketleri sanal ortamdan kaldıracaktır.

python -m pip show belirli bir paket hakkındaki bilgileri görüntüleyecektir:

(tutorial-env) $ python -m pip show requests
---
Metadata-Version: 2.0
Name: requests
Version: 2.7.0
Summary: Python HTTP for Humans.
Home-page: http://python-requests.org
Author: Kenneth Reitz
Author-email: me@kennethreitz.com
License: Apache 2.0
Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages
Requires:

python -m pip list sanal ortamda yüklü olan tüm paketleri gösterecektir:

(tutorial-env) $ python -m pip list
novas (3.1.1.3)
numpy (1.9.2)
pip (7.0.3)
requests (2.7.0)
setuptools (16.0)

python -m pip freeze yüklü paketlerin benzer bir listesini üretecektir, ancak çıktı python -m pip install’ın beklediği biçimi kullanır. Genel bir kullanım bu listeyi bir requirements.txt dosyasına koymaktır:

(tutorial-env) $ python -m pip freeze > requirements.txt
(tutorial-env) $ cat requirements.txt
novas==3.1.1.3
numpy==1.9.2
requests==2.7.0

requirements.txt daha sonra sürüm denetimine kaydedilebilir ve bir uygulamanın parçası olarak gönderilebilir. Kullanıcılar daha sonra gerekli tüm paketleri install -r ile yükleyebilir:

(tutorial-env) $ python -m pip install -r requirements.txt
Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))
  ...
Collecting numpy==1.9.2 (from -r requirements.txt (line 2))
  ...
Collecting requests==2.7.0 (from -r requirements.txt (line 3))
  ...
Installing collected packages: novas, numpy, requests
  Running setup.py install for novas
Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0

pip has many more options. Consult the Python Modüllerini Kurmak guide for complete documentation for pip. When you’ve written a package and want to make it available on the Python Package Index, consult the Python packaging user guide.