This document is for an old version of Python that is no longer supported. You should upgrade, and read the Mevcut kararlı sürüm için olan Python dokümantasyonunu okumalısın..

# 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

Sanal ortamlar oluşturmak ve yönetmek için kullanılan modüle `venv` denir. `venv` genellikle mevcut olan en son Python sürümünü yükler. Sisteminizde birden fazla Python sürümü varsa, `python3` veya istediğiniz sürümü çalıştırarak belirli bir Python sürümünü seçebilirsiniz.

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:

    python3 -m venv tutorial-env

This will create the `tutorial-env` directory if it doesn’t exist, and also create directories inside it containing a copy of the Python interpreter, the standard library, and various supporting files.

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.bat

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']
    >>>

## 12.3. Paketleri pip ile Yönetme

You can install, upgrade, and remove packages using a program called pip. By default `pip` will install packages from the Python Package Index, <https://pypi.org>. You can browse the Python Package Index by going to it in your web browser.

`pip` bir dizi alt komut içerir: “install” (yükle), “uninstall” (kaldır), “freeze” (dondur), vb. (`pip` için eksiksiz dokümantasyon için Installing Python Modules 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 yeniden çalıştırırsanız, `pip` istenen sürümün zaten yüklü olduğunu fark eder ve hiçbir şey yapmaz. Bu sürüme erişmek için farklı bir sürüm numarası edinebilir veya paketi en son sürüme yükseltmek için `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

`pip uninstall` ve ardından bir veya daha fazla paket adı paketleri sanal ortamdan kaldırır.

`pip show` belirli bir paketle ilgili bilgileri görüntüler:

    (tutorial-env) $ 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:

`pip list` sanal ortamda yüklü tüm paketleri görüntüler:

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

`pip freeze` yüklü paketlerin benzer bir listesini oluşturur, ancak çıktı `pip install` beklediği biçimi kullanır. Genel bir kullanım, bu listeyi bir `requirements.txt` dosyasına koymaktır:

    (tutorial-env) $ 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` daha birçok seçeneğe sahiptir. `pip` için eksiksiz dokümantasyona Installing Python Modules adresinden ulaşabilirsiniz. Bir paket yazdığınızda ve paketi Python Paket Dizini’nde kullanılabilir hale getirmek istediğinizde Python Modüllerini Dağıtma rehberine bakın.