- Membuat akun PyPi
- Membuat/mempersiapkan paket yang ingin di publikasi
- Memilih Backend untuk Pembangunan Proyek Python
File pyproject.toml memberitahu alat frontend build seperti pip dan build, mengenai backend mana yang akan digunakan untuk proyek anda. Berikut adalah beberapa contoh untuk backend umum, namun kami sarankan untuk memeriksa dokumentasi backend anda sendiri untuk detail lebih lanjut.
- requires: Daftar paket yang dibutuhkan untuk membangun paket anda. Frontend akan menginstalnya secara otomatis saat membangun paket anda. Frontend biasanya menjalankan build dalam lingkungan terisolasi, jadi jika tidak memasukkan dependensi disini, kemungkinan akan meyebabkan error saat proses build.
- build-backend: Nama objek python yang akan digunakan frontend untuk melakukan build.
Komfigurasi tambahan dari alat build akan berada dibagian tool pada file pyproject.toml atau di dalam file khusus yang ditentukan oleh alat build. Misalnya, saat menggunakan setuptools sebagai backend-build, konfigurasi tambahan dapat ditambahkan pada file setup.py atau setup.cfg, dan menentukan setuptools.build_meta dalam build anda memungkinkan alat untuk menemukan dan menggunakannya secara otomatis.
- Konfigurasi Metadata
Buka file pyproject.toml dan tambahkan konten berikut. Ganti kata your_username dengan nama pengguna anda sendiri. Ini memastikan bahwa nama paket anda unik dan tidak bentrok dengan paket yang diunggah oleh orang lain yang mengikuti tutorial ini.
- name: adalah nama distribusi paket anda.
- version: adalah versi paket. (Beberapa backend-build memungkinkan anda menentukan versi dengan cara lain, seperti dari file atau tag git).
- author: Digunakan untuk mengidentifikasi author paket; Anda perlu menentukan nama dan email untuk setiap author. Anda juga dapat mencantumkan maintener dalam format yang sama.
- description: Adalah ringkasan singkat yang terdiri dari satu kalimat mengenai paket tersebut.
- readme: Adalah path file yang berisi deskripsi paket yang lebih rinci. Deskripsi ini akan ditampilkan pada halaman detail paket di PyPi. Dalam kasus ini, deskripsi dimuat dari file README.md (yang merupakan pola umum). Ada juga bentuk tabel yang lebih canggih, yang dijelaskan dalam panduan pyproject.toml.
- requires-python: Memberikan versi python yang didukung oleh proyek anda. Installer seperti pip akan melihat kembali versi paket yang lebih lama hingga menemukan versi yang cocok dengan versi python.
- classifier: Memberikan indeks dan pip beberapa metadata tambahan tentang paket anda. Dalam kasus ini, paket hanya kompatibel dengan python 3, dilisensi di bawah lisensi MIT, dan tidak bergantung pada sistem operasi (OS-independent). Anda harus selalu menyertakan setidaknya versi python yang mendukung paket anda, lisensi yang tersedia untuk paket anda, dan sistem operasi yang dapat menjalankan paket anda. Untuk informasi lebih lengkap mengenai classifier dapat diilihat pada https://pypi.org/classifiers/ .
- url: memungkinkan anda mencantumkan sejumlah tautan tambahan untuk ditampilkan di PyPi. Umumnya, ini bisa berupa tautan ke sumber kode, dokumentasi, issue tracker, dan lain-lain.
Untuk informasi lebih lanjut, silahkan kunjungi panduan pyproject.toml.
- Membuat README.md
Silahkan buka file README.md dan masukkan konten berikut. Anda juga dapat menyesuaikan isi konten sesuai keinginan anda.
- Membuat Lisensi
Sangat penting bagi sebuah paket yang diunggah ke Python Package Index(PyPI) untuk menyertakan lisensi. Lisensi ini memberitahu pengguna yang menginstall paket anda mengenai ketentuan penggunaan paket tersebut. Untuk mendapatkan bantuan dalam memilih lisensi, anda dapat mengunjungi situs https://choosealicense.com/. Setelah anda memilih lisensi, buka file LICENSE dan masukkan teks lisensi tersebut. Contohnya, jika anda memilih lisensi MIT:
Sebagian besar backend-build akan secara otomatis menyertakan file LICENSE di dalam paket. Untuk detail informasi, anda dapat merujuk ke dokumentasi backend-build yang anda gunakan.
- Menyertakan File-File Lainnya
File-file yang disebutkan di atas akan disertakan secara otomatis ke dalam distribusi sumber anda. Jika anda ingin menyertakan file-file tambahan, silahkan lihat dokumentasi backend yang anda gunakan.
- Membuat Arsip Distribusi
MacOS/Unix
Windows
Sekarang jalankan perintah berikut ini dari direktori yang sama tempat file pyproject.toml berada:
MacOS/Unix
Windows
Perintah tersebut akan menghasilkan banyak teks dan setelah selesai, akan menghasilkan dua file di direktori disk:
Untuk menerbitkan paket python ke PyPI, anda harus membuat dua jenis arsip distribusi: arsip sumber (.tar.gz) dan arsip yang sudah dibangun(.whl).Arsip sumber dapat diinstall dengan pip, tetapi versi pip yang lebih baru akan secara otomatis memilih untuk menginstall arsip yang sudah dibangun jika tersedia.
- Mengunggah Arsip Distribusi
- Buat akun di https://test.pypi.org/account/register/ untuk pengujian sebelum mengunggah ke PyPI resmi.
- Verifikasi alamat email anda.
- Silahka kunjungi https://test.pypi.org/manage/account/#api-tokens untuk membuat token API PyPI.
- Atur "scope" ke "entire account".
- Salin dan simpan token di tempat yang aman.
- Install Twine dengan perintah berikut
Komentar
Posting Komentar