Jumat, 17 Maret 2017

Cara Menambahkan Library ke PyPi atau Python Package Index

Hal yang paling menyenangkan saat menggunakan bahasa pemrograman python adalah library yang seperti tak ada habisnya. Anda bisa mencari berbagai macam library di PyPi, kemudian memasangnya pada komputer anda hanya dengan perintah: pip install nama-paket. Begitu mudah bukan? Kemudian, bagaimana jika anda mempunyai library anda sendiri dan ingin membagikannya melalui PyPi? Kali ini saya akan membagikan pengalaman saya menambahkan library ke Pypi.

Berikut adalah Cara Menambahkan Library ke PyPi atau Python Package Index:

Notes: Pada tutorial ini, anda disarankan menggunakan platform Linux. (saya menggunakan Linux Deepin 15.3)

 

1. Siapkan library anda

Pertama, siapkan library anda terlebih dahulu. Buka terminal kemudian ubah direktori kerja ke lokasi library anda. Kemudian lakukan test dengan menjalankan perintah berikut:
python setup.py test

Jika tidak ada pesan error maka library anda siap untuk di tambahkan ke PyPi.

 

2. Lakukan pendaftaran di PyPi

Buat akun anda terlebih dahulu, anda bisa mendaftarkan diri anda disini. Isi semua kolom yang tersedia, kemudian tekan tombol . Jika tidak ada pesan kesalahan, silahkan cek kotak masuk email anda. Buka email dari PyPi Admin dan klik link yang tercantum untuk mengkonfirmasi akun anda.
Jika akun anda sudah terkonfirmasi, silahkan masuk ke akun anda disini.

 

3. Pesiapan sebelum mengunggah library

Ada banyak cara untuk mengunggah library ke PyPi, namun cara yang paling di sarankan adalah menggunakan Twine karena di nilai lebih aman. Ketik perintah berikut untuk memasang Twine pada komputer anda:
sudo pip install twine

Jika tidak muncul pesan kesalahan, tambahkan file konfigurasi data akun PyPi anda. Ketik perintah berikut:
nano ~/.pypirc

kemudian salin text berikut ke text editor nano:
[distutils]
index-servers=pypi

[pypi]
repository = https://upload.pypi.org/legacy/
username = <username>
password = <password>

Ubah <username> dan <password> sesuai data akun PyPi anda. Jika sudah benar, tekan CTRL+O kemudian enter, lalu CTRL+X untuk keluar dari text editor.

 

4. Unggah library ke PyPi

Lakukan proses build pada libray anda dengan perintah berikut:
python setup.py sdist bdist_wheel

Jika tidak ada pesan kesalahan, langkah selanjutnya adalah register PKG-INFO library anda disini. Ikuti langkah-langkah berikut ini:
  1. Login ke akun PyPi anda disini
  2. Klik link berikut untuk menuju halaman unggah file PKG-INFO.
  3. Tekan tombol , lalu cari file PKG-INFO library anda pada <nama_library>.egg-info/PKG-INFO.
  4. Tekan tombol .
Jika langkah-langkah di atas berhasil maka anda akan di arahkahkan ke halaman yang berisi informasi library anda.

Setelah proses register library selesai,  selanjutnya adalah proses pengunggahan library ke PyPi. Ketik perintah berikut pada terminal:
twine upload dist/*

Jika tidak ada pesan kesalahan, maka library anda telah masuk ke dalam PyPi: Python Package Index.

 

 5. Test library anda

Test library anda dengan PIP, untuk mengetahui apakah seluruh proses benar dan tidak ada kesalahan. Ketik perintah berikut:
sudo pip install <nama-library-anda>


Jika proses berhasil, selamat library anda sudah tersedia untuk dunia.


Sekian, terimakasih.

Em Suryadi

Sumber:
  1. https://packaging.python.org/distributing/#uploading-your-project-to-pypi

Show Comments