Kendi Python paketini oluştur ve dağıt

Her şey, kendi Python - paketlerini nasıl oluşturup etkili bir şekilde dağıtabileceğin sorusuyla başlar. Bu rehberde, adım adım bir paket geliştirmenin yolunu gösteriyorum ve bunu başkalarıyla paylaşabilirsin. Doğru dosyaları oluşturmak ve doğru yapıyı sağlamak hayati önem taşır. Bu, başkalarının paketini kolayca yükleyip kullanmasını sağlar. Haydi hemen başlayalım ve paket dağıtımının temellerini keşfedelim.

En önemli bulgular

1. Paketin tüm meta verilerini içeren bir setup.py dosyası oluştur.
2. Tüm Python dışı dosyaları listeleyen bir Manifest dosyası ekle.
3. Distribyonunu oluşturmak için terminalde doğru komutu kullan.
4. Açılan paket kolayca yükleme için verilebilir.

Adım Adım Rehber

Kendi Python paketini oluşturmak için takip etmen gereken bazı kritik adımlar vardır. Aşağıda, kendi paket dağıtımına giden yolu gösteren ekran görüntüleriyle detaylı bir rehber bulacaksın.

Dizini Yapısını Oluşturma

Öncelikle, paketin için uygun dizin yapısını hazırlamalısın. Tüm dosyaların ve alt dizinlerin bulunduğu bir ana dizin oluştur, buna kaynak kodu, dokümantasyon ve lisans bilgileri de dahil.

Bu örnekte, bir README.md dosyası ve bir lisans dosyasıyla basit bir yapı hazırlıyorum. Paketinin haklarını belirlemek için GPL lisansını kullanabilirsin.

API Yapısını Tanımlama

Paketini faydalı hale getirmek için en az bir API dokümantasyonu ve diğer sınıfların miras alabileceği bir temel sınıf gereklidir. Bu yapı, paketinin genişletilmesi ve özelleştirilmesini sağlar.

Basit bir API ve envanter sınıfı mükemmel bir başlangıç sunabilir.

setup.py Dosyasını Oluşturma

Paketinin merkezi bileşeni setup.py dosyasıdır. Burada, kurulum sürecinde gerekli olan tüm proje bilgilerini tanımlarsın.

Bu dosyada, gerekli modülleri içe aktarırsın ve paketinin adını, yazarını, e-posta adresini, sürüm numarasını ve web sitesini içeren temel bilgileri belirtirsin.

Gerekli Paketlerin Belirtilmesi

Paketinin tüm bağımlılıklarının belirtilmiş olduğundan emin olmalısın. Bu, setup.py dosasında, paketinin teslim edileceği paketlerin bir listesini ekleyerek olur.

Burada ana sınıf ve belirli kapsamlı sınıflar gibi gerekli alt paketleri ekle.

Manifest Dosyası Oluşturma

Tüm ilgili Python dışı dosyaların paketine dahil edildiğinden emin olmak için bir manifest dosyası oluştur. Bu dosya, paketleme sırasında dikkate alınacak tüm dosyaları listeler.

Bu dosyada, hangi dosya türlerinin pakete dahil edilmesi gerektiğini ve dokümantasyon gibi dizinleri belirtirsin.

Dağıtımı Oluşturma için Terminal Komutları

Artık paketi oluşturma zamanı geldi. Terminalini aç ve setup.py dosyanın bulunduğu dizine git. Burada paket oluşturma komutunu çalıştırabilirsin.

Oluşturulan Dosyaların Kontrolü

Dağıtımı oluşturduktan sonra, paketini içeren bir dist adlı dizin bulmalısın.

Artık bu dosyayı paylaşabilir veya yükleyebilirsin.

Paketin Kurulumu

Paketinin doğru çalıştığından emin olmak için, kendin tekrar yükleyebilirsin. Bunun için dizini aç ve setup.py dosyasını tekrar çalıştır.

Yönetici yetkisi olmayan kullanıcılar için, mevcut kullanıcı için yükleme komutunu çalıştırabilirsin:

python setup.py install --user

Kullanıcılar için Dağıtım

Paketini dağıtmak istiyorsan, README.md, lisans ve setup.py gibi tüm dosyaların dahil olduğundan emin ol. Bu, kullanıcının indirirken paketin doğru bir şekilde yüklenmesini sağlar.

İşte paketin dosya sisteminde hazır ve başkalarına aktarılabilir.

Özet – Python Paketlerini Doğru Paketle

Artık kendi Python paketlerin için kapsamlı bir yapı oluşturmayı ve kolayca dağıtabileceğin bir dağıtım oluşturmayı öğrendin. Dizin yapısını oluşturmaktan son kullanıcı tarafından kurulum aşamasına kadar, kendi paketini etkili bir şekilde dağıtmak için gereken tüm adımları geçtin.