Python İle Oluşturduğunuz Paketlerinizi(Modüllerinizi) PyPI’da Yayınlama Rehberi 4 PyPI’a Yüklenecek Modülün Hazırlanması

Merhabalar bu yazımızda PyPI’a gönderilecek olan modülümüzün klasör yapısının nasıl olması gerektiğine bakacak ve modülümüzü kodlayacağız.

Bu anlatımlarımız boyunca kullanacağımız modülümüz 4 işlem yapan bir hesap makinesi modülü olacak.

Kendi Calculator Class’ımızı ve buna bağlı Ekle – Çıkar – Çarp – Böl fonksiyonlarını yazacağız.

Her bir fonksiyon 2 adet parametre alacak ve sonucu geri döndürüyor olacaktır.

1 Proje Klasörünü Oluştur

Calculator isminde bir proje dosyası oluşturalım(Dizin fark etmez).

2 Proje Klasörünü VS Code İle Aç

Calculator isimli proje klasörünü VS Code ile açalım. Burada farklı editörler kullanabilirsiniz. Tamamen sizin tercihinize kalmıştır.

Bir dosyanın VS Code ile nasıl açılacağını aşağıdaki yazıma göz atarak öğrenebilirsiniz.

Not: Birazdan terminal üzerinden yapacağımız işlemler için Python ve pip kurulumlarının tam olması gerekir.

3 VS Code Üzerinde Terminal Aç

Calculator proje dosyası içine odaklanmış şekilde bir terminal açalım.

4 Pip Kurulumu ve Güncellemesini Gerçekleştir

Pip kurulumu ve güncellemesi için terminalde aşağıdaki komutu çalıştıralım ve son sürüme getirelim Pip kurulumunu.

python -m pip install --upgrade pip

4 Klasör Yapısına Göz At

Modül oluştururken klasör yapımız aşağıdakine benzer olacaktır.

packaging_tutorial/
└── src/
    └── example_package_YOUR_USERNAME_HERE/
        ├── __init__.py
        └── example.py

5 src Klasörünü Oluştur

Şimdi kök dizinde src isminde bir klasör oluşturalım.

6 src İçinde Modülümüzün İsmi Olacak Bir Klasör Oluştur

Burada oluşturulacak klasör modülümüzün PyPI’a yüklenme ismi olacaktır ve bunun benzersiz bir isim olması gerekir. Bunun için şöyle bir şey düşünmüşler ModuleName_Username. Burada kullanılan username sayesinde modülümüz mutlaka benzersiz hale gelmiş olacak.

Ancak bunu yapmak zorunlu değildir. Yeter ki modülümüzün ismi bugüne kadar oluşturulmuş hiçbir paket ismiyle eşleşmesin.

Ben Modülümü MBCalculator olarak oluşturacağım. O yüzden bu isimde bir klasör oluşturuyorum.

7 MBCalculator Klasörü İçinde __init__.py Dosyasını Oluştur

Bu dosya içinde herhangi bir kod olmasa da oluşturulmak zorundadır. Bu projenin bir modül olduğunu anlatmış oluyoruz böylelikle.

Artık MBCalculator altında Modülün iş yapacak tüm dosyaları, sınıfları, metodları oluşturulabilir.

8 MBCalculator Altında Calc.py İsminde Bir Dosya Oluştur

9 Calc.py Dosyası İçine Aşağıdaki Kodları Ekleyelim

class Calc():

    def __init__(self):
        self.result = 0
    
    def add(self, a, b):
        self.result = a + b
        return self.result
    
    def sub(self, a, b):
        self.result = a - b
        return self.result
    
    def mul(self, a, b):
        self.result = a * b
        return self.result
    
    def div(self, a, b):
        self.result = a / b
        return self.result
   
        

Böylece modülümüzün kodlama kısmını halletmiş olduk.

Bir sonraki bölümde Build ve Release işlemi için konfigurasyon ayarlarına ve dosyalarına bakacağız.