Python’da Kütüphane Nasıl Kurulur: Eksiksiz Adım Adım Kılavuz

Python, dünyanın en çok yönlü ve yaygın olarak benimsenen programlama dillerinden biridir ve gücünün büyük bir kısmı devasa bir üçüncü taraf kütüphane ekosisteminden gelir. Bu kütüphaneler, geliştiricilerin her seferinde sıfırdan başlamadan web uygulamaları oluşturmasına, iş akışlarını otomatikleştirmesine, veri analizi yapmasına, makine öğrenimi modelleri eğitmesine ve çok daha fazlasını yapmasına olanak tanıyan hazır, savaşta test edilmiş kodlar sunar.

Python betiklerini yerel makinenizde, bir VPS Hosting ortamında veya özel bir sunucuda çalıştırıyor olun, Python kütüphanelerini nasıl kuracağınızı, yöneteceğinizi ve bakımını yapacağınızı bilmek, her geliştirici ve sistem yöneticisinin ustalaşması gereken temel bir beceridir.

Bu kılavuz, Python kurulumunuzu doğrulamaktan sanal ortamları kullanmaya ve bağımlılıkları büyük ölçekte yönetmeye kadar sürecin her adımını ele almaktadır.

—

Ön Koşullar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

• Bir terminale (Linux/macOS) veya Komut İstemi / PowerShell’e (Windows) erişim
• Yazılım yüklemek için yeterli izinler (veya aşağıda ele alınan bir sanal ortam)
• PyPI’dan paket indirmek için aktif bir internet bağlantısı

—

Adım 1: Python’un Kurulu Olduğunu Doğrulayın

Herhangi bir kütüphane kurmadan önce, Python’un sisteminizde mevcut olduğunu doğrulayın.

Terminalinizi veya komut isteminizi açın ve şunu çalıştırın:

python --version

Ya da Python 3’ün açıkça gerekli olduğu sistemlerde:

python3 --version

Beklenen çıktı:

Python 3.11.4

Python Kurulu Değilse

• Windows: Resmi yükleyiciyi https://www.python.org/downloads/ adresinden indirin. Kurulum sırasında, “Add Python to PATH” etiketli kutuyu işaretleyin — bu, Python’u komut satırından çalıştırmak için kritik öneme sahiptir.
• Ubuntu/Debian Linux:

  sudo apt update && sudo apt install python3

• CentOS/RHEL/AlmaLinux:

  sudo dnf install python3

• macOS (Homebrew ile):

  brew install python

> Sistem yöneticisi ipucu: Dedicated Servers dahil üretim sunucularında, güvenlik yamalarının otomatik olarak uygulanmasını sağlamak için Python’u her zaman dağıtımınızın paket yöneticisi aracılığıyla kurmayı tercih edin.

—

Adım 2: pip’in Kurulu Olduğunu Doğrulayın

pip, Python’un varsayılan paket yükleyicisidir. Yüz binlerce açık kaynak kütüphaneyi barındıran bir depo olan Python Package Index (PyPI)‘ye bağlanır ve indirme, bağımlılık çözümleme ve kurulum işlemlerini otomatik olarak gerçekleştirir.

pip’in mevcut olup olmadığını kontrol edin:

pip --version

Ya da:

pip3 --version

Beklenen çıktı:

pip 23.2.1 from /usr/lib/python3/dist-packages/pip (python 3.11)

pip Kurulu Değilse

Resmi önyükleme betiğini indirin ve çalıştırın:

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py

Alternatif olarak, Debian/Ubuntu’da:

sudo apt install python3-pip

Kurulduktan sonra pip kullanıma hazırdır.

—

Adım 3: pip Kullanarak Python Kütüphanesi Kurma

Python ve pip doğrulandıktan sonra, tek bir komutla PyPI’dan herhangi bir kütüphane kurabilirsiniz.

Temel sözdizimi:

pip install library_name

Örnek — requests HTTP kütüphanesini kurma:

pip install requests

pip şunları yapacaktır:

1. Tüm bağımlılıkları otomatik olarak çözümleme
2. Gerekli paketleri indirme
3. Her şeyi Python ortamınıza kurma

Aşağıdakine benzer bir çıktı göreceksiniz:

Collecting requests
  Downloading requests-2.31.0-py3-none-any.whl (62 kB)
Installing collected packages: urllib3, certifi, charset-normalizer, idna, requests
Successfully installed requests-2.31.0

—

Adım 4: Kütüphanenin Başarıyla Kurulduğunu Doğrulayın

Kurulumdan sonra, Python etkileşimli kabuğunda içe aktararak kütüphanenin doğru çalıştığını doğrulayın.

Python kabuğunu başlatın:

python

Ardından kütüphaneyi içe aktarmayı deneyin:

import requests
print(requests.__version__)

Beklenen çıktı:

2.31.0

İçe aktarma hatasız tamamlanırsa, kurulum başarılı olmuştur. Bir ModuleNotFoundError görürseniz, kütüphane aktif Python ortamına kurulmamış demektir — bu, aynı sistemde birden fazla Python sürümü veya ortamı bir arada bulunduğunda sık karşılaşılan bir sorundur.

—

Adım 5: Bir Kütüphanenin Belirli Bir Sürümünü Kurma

Üretim ortamlarında bağımlılık sabitleme kritik öneme sahiptir. Bir kütüphanenin farklı sürümleri farklı davranabilir veya kırıcı değişiklikler getirebilir. Kesin bir sürüm kurmak için:

pip install library_name==version_number

Örnek:

pip install requests==2.25.1

Ayrıca sürüm aralıkları da tanımlayabilirsiniz:

pip install "requests>=2.25.0,<3.0.0"

Bu, belirtilen aralık içinde en son uyumlu sürümü kurar — büyük sürüm yükseltmeleri riskini almadan esnekliğe ihtiyaç duyduğunuzda kullanışlıdır.

—

Adım 6: Mevcut Bir Kütüphaneyi Güncelleme

Bir kütüphaneyi mevcut en son sürüme güncellemek için:

pip install --upgrade library_name

Örnek:

pip install --upgrade requests

pip’in kendisini güncellemek için (düzenli olarak önerilir):

pip install --upgrade pip

> En iyi uygulama: Paylaşımlı hosting ortamlarında veya cPanel ile VPS‘de, mevcut uygulamaları bozmamak için güncellemeleri üretime uygulamadan önce her zaman sanal bir ortamda test edin.

—

Adım 7: Bir requirements.txt Dosyasından Birden Fazla Kütüphane Kurma

Basit bir betiğin ötesindeki herhangi bir proje için, bağımlılıklarınızı bir requirements.txt dosyasında takip etmelisiniz. Bu, projenizin farklı makineler, sunucular ve ekip üyeleri arasında yeniden üretilebilir olmasını sağlar.

requirements.txt Dosyası Oluşturma

requirements.txt adında düz bir metin dosyası oluşturun ve her bağımlılığı sabitlenmiş sürümüyle listeleyin:

requests==2.31.0
numpy==1.25.2
pandas==2.0.3
flask==3.0.0
sqlalchemy==2.0.20

Tüm Bağımlılıkları Aynı Anda Kurma

pip install -r requirements.txt

pip dosyayı okur ve listelenen her paketi doğru sürümüyle kurar.

requirements.txt Dosyasını Otomatik Olarak Oluşturma

Ortamınızın mevcut durumunu kaydetmek istiyorsanız:

pip freeze > requirements.txt

Bu, şu anda kurulu tüm paketleri ve tam sürümlerini dışa aktarır — bir sunucuya dağıtmadan önce çalışan bir ortamı kilitlemek için idealdir.

—

Adım 8: Bağımlılıkları İzole Etmek İçin Sanal Ortamları Kullanma

Bu, Python geliştirmede tartışmasız en önemli en iyi uygulamadır. Sanal ortamlar, her proje için izole Python ortamları oluşturarak projeler arasındaki bağımlılık çakışmalarını önler ve global Python kurulumunuzu temiz tutar.

Sanal Ortamların Önemi

Proje A’nın requests==2.25.1 gerektirdiğini ve Proje B’nin requests==2.31.0 gerektirdiğini hayal edin. Sanal ortamlar olmadan, yalnızca bir sürüm global olarak var olabilir — bu da bir projenin bozulmasına neden olur. Sanal ortamlar bunu tamamen çözer.

Adım Adım: Sanal Ortam Oluşturma ve Kullanma

1. virtualenv kurulumu (henüz mevcut değilse):

pip install virtualenv

Alternatif olarak, yerleşik venv modülünü kullanın (Python 3.3+):

python -m venv venv

2. Proje dizininizde bir sanal ortam oluşturun:

virtualenv venv

Bu, izole bir Python yorumlayıcısı ve pip içeren bir venv/ klasörü oluşturur.

3. Sanal ortamı etkinleştirin:

• Linux/macOS:

  source venv/bin/activate

• Windows (Komut İstemi):

  venvScriptsactivate

• Windows (PowerShell):

  venvScriptsActivate.ps1

Etkinleştirildikten sonra, terminal isteminiz izole ortamın aktif olduğunu belirtmek için (venv) gösterecek şekilde değişir.

4. Sanal ortam içinde kütüphaneleri kurun:

pip install requests flask numpy

Tüm paketler yalnızca venv/ içine kurulur — global Python kurulumunuz etkilenmez.

5. İşiniz bittiğinde sanal ortamı devre dışı bırakın:

deactivate

> Profesyonel ipucu: venv/ dizininizi .gitignore dosyasına ekleyin, böylece sürüm kontrolüne hiçbir zaman dahil edilmez. Yalnızca requirements.txt dosyasını kaydedin.

—

Adım 9: Bir Kütüphaneyi Kaldırma

Artık bir kütüphaneye ihtiyaç duymuyorsanız, şu komutla temizce kaldırın:

pip uninstall library_name

Örnek:

pip uninstall requests

pip, paketi kaldırmadan önce onaylamanızı isteyecektir. Onay istemini atlamak için (betiklerde kullanışlıdır):

pip uninstall -y requests

Bir requirements.txt dosyasında listelenen tüm paketleri kaldırmak için:

pip uninstall -r requirements.txt -y

—

Bonus: Günlük Yönetim İçin Kullanışlı pip Komutları

—

Yaygın Hatalar ve Çözümleri

ModuleNotFoundError: No module named 'requests'

Kütüphaneyi pip ile kurdunuz ancak farklı bir Python yorumlayıcısı çalıştırıyorsunuz. pip’in doğru Python sürümüne kurulum yapmasını sağlamak için python -m pip install requests kullanın.

Linux’ta Permission denied hataları

Global olarak sudo pip install kullanmaktan kaçının. Bunun yerine bir sanal ortam kullanın veya yalnızca mevcut kullanıcı için kurun:

pip install --user library_name

Kurulum sırasında SSL sertifika hataları

Bu durum, yanlış yapılandırılmış SSL’e sahip sunucularda ortaya çıkabilir. Sisteminizin CA sertifikalarının güncel olduğundan emin olun. Kendi sunucu altyapınızı yönetiyorsanız, tüm hizmetlerde güvenli bir ortam sağlamak için bunu düzgün şekilde verilmiş SSL Sertifikaları ile eşleştirmeyi düşünün.

Windows’ta Python kurulumundan sonra pip bulunamadı

Python’un kurulum sırasında PATH’e eklendiğinden emin olun. Yükleyiciyi yeniden çalıştırın ve “Modify” seçeneğini belirleyin, ardından PATH seçeneğini etkinleştirin.

—

Bir Sunucuda Python Uygulamaları Dağıtma

Barındırılan bir ortamda çalışması gereken Python tabanlı web uygulamaları, otomasyon betikleri veya veri işlem hatları oluşturuyorsanız, altyapı seçiminiz önemli ölçüde belirleyici olur.

• VPS Hosting, herhangi bir Python sürümü kurmanız, sanal ortamları yönetmeniz, sistem hizmetlerini yapılandırmanız ve Django, Flask veya FastAPI gibi çerçeveler dağıtmanız için tam root erişimi sağlar.
• Dedicated Servers, büyük ölçekli veri işleme, web kazıma altyapısı veya yüksek trafikli API’ler gibi kaynak yoğun Python iş yükleri için idealdir.
• GPU Hosting, TensorFlow, PyTorch veya CUDA hızlandırmalı NumPy gibi kütüphanelere dayanan makine öğrenimi ve yapay zeka projeleri için doğru seçimdir.

—

Sonuç

Python kütüphanelerini kurmak ve yönetmek, projelerinizin kalitesini, kararlılığını ve yeniden üretilebilirliğini doğrudan etkileyen temel bir beceridir. İşte ele aldıklarımızın hızlı bir özeti:

1. Python ve pip’in kurulu ve erişilebilir olduğunu doğrulayın
2. PyPI’dan kütüphane kurmak için pip install kullanın
3. Üretim kararlılığı için belirli sürümleri sabitleyin
4. --upgrade bayrağıyla kütüphaneleri güncelleyin
5. Proje bağımlılıklarını bildirimsel olarak yönetmek için requirements.txt kullanın
6. Proje bağımlılıklarını izole etmek için her zaman sanal ortamları kullanın
7. pip uninstall ile temizce kaldırın

Bu uygulamaları tutarlı bir şekilde takip ederek — ister yerel olarak geliştiriyor ister bir VPS Hosting ortamında dağıtıyor olun — daha güvenilir, sürdürülebilir ve profesyonel Python uygulamaları oluşturacaksınız.