Python Modüllerini PyPi Üzerinde Paylaşmak

Python

Merhaba bu yazıda Python ile yazdığımız paketlerin PyPi üzerinde nasıl paylaşılacağını anlatacağım. Aslında rivayet odur ki ben bu yazıyı yazmışım. Yaklaşık 4 yıl önce. Ama tekrar yazmanın zararı yok.

Kevser Sırça şöyle bir tweet atmıştı

PyPi Nedir?

İşin fransızlarına gem, npm, nuget, composer dersem anlaşılır olabilir sanırım. Kendi projeleri için python modülleri yazan abiler, bu modülleri başkaları da kullanmalı diyerek PyPi üzerine yüklemeler gerçekleştirirler. Bizler de sonraları bu modülleri kullanırız.

Bash komutu django kurulumunu gerçekleştirecektir. Siz de benim atomu parçalayan modülümün herkesçe kullanılmasını isteyenlerdenim diyorsanız bu yazı tam size göre.

Başlamadan Önce

https://pypi.python.org/pypi adresinden (yeni sekmede açın) bir hesap oluşturalım. Burada kullanacağınız parola büyüklü küçüklü harf ve rakam içeren türden olmalı. PGP alanı için bir zorunluluk bulunmamakta.

Aynı kayıt işlemini Test sitesi için de gerçekleştirelim. Bu Python modülleri için test adresidir. https://testpypi.python.org/pypi. Aslında bu çok önemli değil ama buraya kayıt olun siz.

Kayıt olurken aynı kullanıcı adı ve parola ile kayıt olmanız neydi lan benim hesap bilgileri gibi sorular sormanıza da engel olacaktır.

Bu test üyeliğini biraz sonra göreceğimiz ayar dosyasında belirtebiliriz.

.pypirc

Python modüllerini yukarıya atarken yetkilendirme işlemlerini sağlayacağımız pypirc dosyasını nano yardımıyla oluşturalım.

Örnek bir .pypirc dosyası şöyle olmalı

CTRL + x ve Y yaparak dosyayı kaydedin. Dikkat ettiyseniz eğer test ve gerçek depo adresi için kullanıcı adı ve parola bilgileri ayrı ayrı veriliyor.

Proje Yapısı

Proje adını say_hello olarak verdiğimizi varsayalım. Bu projenin yapısı şöyle olmalıdır:

Burada yer alan hello.py ve merhaba.py projenizde yer alan dosyalar olacaktır. Bu adımdan sonra setup.py dosyasını oluşturmalıyız. Bu dosya projenin temel bilgilerini saklıyor olacak. Kısacası metadata diyebiliriz.

setup.py Dosyası

Bu dosya için distutils modülünü import etmeliyiz.

Genel olarak kodları vereyim ve açıklamasını yapayım:

Packages kısmında yer alan değer, name değeriyle aynı olmalı. Diğer kısımlar açıkcası çok zorlayıcı değil. Proje url’i için github vermek zorunlu değil. Ancak çoğu kişi bu adresi veriyor. İsterseniz download_url kısmına kendi sitenizin adresini de verebilirsiniz. Ayrıca paket için gerekli keywordleri mantıklı bir şekilde seçmeniz, erişilebilir olmasına imkan tanıyacaktır.

setup.cfg

Asıl metadata bilgisinin yani proje açıklama bilgisinin girileceği (markdown olabilir, rst olabilir) yer burası. Direkt bir açıklama girmek yerine oluşturduğumuz readme dosyasını kullanabiliriz:

Her şey tamam ise şu komutu çalıştırıp öncelikle dist klasörümüzü oluşturalım. python setup.py sdist Bu komut oluşturduğumuz projeyi arşiv dosyası halinde dist klasörü altına oluşturacaktır.

Örneğin paket adımız mehmet olsun. Bunun oluşan arşiv dosyası adı mehmet-VERSIYON.tar.gz şeklinde olacaktır.

twine Kurulumu

Her şey hazır, şimdi twine kurulumuna geçelim. Python dokümantasyonlarında da kullanılan twine ile paketlerimizi yukarıya atılabilir hale getiriyoruz. Bu paketleri hem PyPi live hem de PyPi test üzerine yollayabiliriz yani.

Bu komutla twine kurulumunu yapalım ve sonraki adıma geçelim.

Test Sitesi Üzerinde Kontrol

Yazının başından da hatırlayacağınız gibi hem test hem de live için kayıt olduk. Bu paketi öncelikle test üzerinde kontrol edelim.

Eğer HTTPError: 410 Client Error: Project pre-registration is no longer required or supported, so continue directly to uploading files. hatası alırsanız

komutunu kullanarak yukarıya direkt gönderebilirsiniz. TestPyPi sitesinde sağ tarafa bakarsak yayınladığımız paket oralarda boş boş durmakta.

Burada yer alan -r flag ise hangi repository üzerinde paketin gönderileceğini belirtiyor. Kısacası şu an hala test modülünde çalışıyoruz. Bunu live PyPi üzerine atalım.

Bunun için direkt olarak upload komutunu kullanalım ve dist altında yer alan tüm dosyaları belirtelim. Zorunlu değil. Eğer isterseniz tek bir dosyayı da seçebilirsiniz.

Dosyamız yüklendikten sonra gerçekten live üzerinde yer alıyor mu kontrol etmeliyiz. Basitçe paketimizi kuralum pip install paketimiz

Ardından ben Python3 ile deniyorum