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.