Python Paketleri Nasıl Oluşturulur ve Pypı'a Nasıl Yüklenir?

### Python Paketleri Nasıl Oluşturulur ve PyPI'a Nasıl Yüklenir?

Python, geniş bir kütüphane ve modül ekosistemine sahip bir programlama dilidir. Geliştiriciler, projelerinde kullanmak üzere kendi paketlerini oluşturabilir ve bu paketleri Python Package Index (PyPI) gibi platformlarda paylaşabilir. Bu rehberde, Python paketleri oluşturmanın ve bunları PyPI'a yüklemenin adımlarını detaylı bir şekilde inceleyeceğiz.

#### 1. Python Paketinin Temelleri

Python paketi, bir veya birden fazla modül içeren bir dizindir. Her Python paketi, bir `init.py` dosyası ile başlar. Bu dosya, Python’a bu dizinin bir paket olduğunu belirtir ve birçok durumda bu dosya boş bırakılabilir.

Örnek Dizin Yapısı:
```
mypackage/
├── mymodule.py
├── init.py
└── setup.py
```

#### 2. Gerekli Araçların Kurulumu

Python paketleri oluşturmak için bazı araçlara ihtiyacınız olacak. Öncelikle, `setuptools` ve `wheel` kütüphanelerini yüklemeniz gerekmektedir. Bu kütüphaneler, paketlerinizi oluşturmanıza ve dağıtmanıza yardımcı olur.

```bash
pip install setuptools wheel
```

#### 3. Paket Yapısının Oluşturulması

Paketinizi oluşturmak için bir `setup.py` dosyası oluşturmalısınız. Bu dosya, paketinize dair bilgileri içerecek ve PyPI’a yükleme sırasında gerekli olan meta verileri sağlayacaktır.

setup.py Örneği:
```python
from setuptools import setup, findpackages

setup(
name='mypackage',
version='0.1.0',
author='Adınız',
authoremail='email@example.com',
description='Kısa bir açıklama',
packages=findpackages(),
installrequires=[
# Gerekli bağımlılıkları burada listeleyin
],
)
```

Bu dosyada, paketin adı, versiyonu, yazarı ve açıklaması gibi bilgileri doldurmalısınız.

#### 4. Paketinizi Oluşturma

Paketinizi oluşturmak için terminalde, `setup.py` dosyanızın bulunduğu dizine gidin ve aşağıdaki komutu çalıştırın:

```bash
python setup.py sdist bdistwheel
```

Bu komut, `dist` adlı bir dizin oluşturacak ve içinde `.tar.gz` ve `.whl` dosyaları bulunduracaktır. Bu dosyalar, PyPI’a yüklemek için gereklidir.

#### 5. PyPI’a Yükleme

PyPI’a yükleme yapmak için `twine` aracını kullanacağız. Öncelikle `twine` kütüphanesini yükleyin:

```bash
pip install twine
```

Sonrasında, aşağıdaki komutla paketlerinizi PyPI’a yükleyebilirsiniz:

```bash
twine upload dist/*
```

Bu komut, `dist` dizinindeki tüm paketleri PyPI’a yükler. Yükleme sırasında, PyPI'daki kullanıcı adınızı ve şifrenizi girmeniz istenecektir.

#### 6. Paketinizin Kontrolü

Yükleme işlemi tamamlandıktan sonra, paketinizin PyPI üzerinde göründüğünden emin olun. [PyPI](https://pypi.org/) adresine gidin ve paket adınızı aratın. Paketinizi burada bulabiliyorsanız, yükleme işleminiz başarılı olmuştur.

#### 7. Ek İpuçları

- ReadMe Dosyası: Paketinizin kök dizinine bir `README.md` dosyası ekleyerek, kullanıcıların paketinizi nasıl kullanacaklarına dair bilgi verebilirsiniz.
- Sürüm Yönetimi: Her değişiklikte versiyon numaranızı güncelleyerek kullanıcılarınızın en güncel sürümü kullanmasını sağlayın.
- Bağımlılıklar: `install_requires` bölümüne, paketinizin çalışması için gerekli olan diğer paketleri eklemeyi unutmayın.

#### 8. Sık Yapılan Hatalar

- `setup.py` dosyasında eksik veya hatalı bilgi vermek, yükleme sırasında sorunlara yol açabilir.
- Kütüphaneleri güncel tutmamak, kullanıcıların sorun yaşamasına sebep olabilir.

### Sık Sorulan Sorular (SSS)

1. Paketimi nasıl güncelleyebilirim?
Paketinizin `setup.py` dosyasında versiyon numarasını güncelleyip yeniden yükleyin.

2. PyPI'a yükleme yaparken hata alırsam ne yapmalıyım?
Hata mesajını dikkatlice okuyun; genellikle eksik bir bilgi veya hatalı bir dosya yapısı nedeniyle hata alırsınız.

3. Paketim ücretsiz mi olmalı?
PyPI'da paylaşılan paketler genellikle ücretsizdir, ancak ticari kullanım için lisans eklemeyi düşünebilirsiniz.

###