Membuat Sendiri NPM Package — Id More Academy
NPM berisi berbagai modul yang nanti bisa digunakan oleh para developer yang menggunakan Javascript. Postingan ini mengajak kamu untuk berkontribusi di NPM, tapi pastikan sebelum publikasi kesana module yang kamu buat unik, less bud, dan kodingnya dibuat efisien dan efektif, yuk langsung mulai saja.
Prasyarat
Berikut beberapa yang terlebih dahulu harus kamu instal di komputer kamu :
- Node JS dan NPM (wajib) : https://nodejs.org/en/
- Atau bisa juga menggunakan Yarn sebagai alternative NPM : https://yarnpkg.com
Inisialisasi Project
Langkah awal tentu saja inisialisasi project. Buat direktori kosong terlebih dahulu, untuk kemudian masuk ke direktori tersebut dan di terminal eksekusi perintah
Sisanya kamu akan dihadapkan dengan berbagai form, isinya meliputi nama package, version, description dan hal — hal dasar lainnya yang berhubungan dengan package, isinya persis dengan package.json atau bisa kamu lihat preview dibawah.
Mulai Koding
Jika dilihat di package.json terlihat property “main”: “index.js” , itu ditujukan sebagai file inisial alias file utama yang dipanggil ketika package ini diimport.
Karena package ini cuma dummy, jadi cuma saya isi untuk stripTags function.
module.exports.stripTags = function(html = "") { // <b> or </b> => "" "" if(typeof html !== "string") return html const text = html.replace(/<[^>]+>/gi, "") return text }
Untuk saat ini seja tulisan ini dibuat, NPM hanya support ES5 jadi kodingnya pakai standar itu ya, atau bisa menggunakan versi diatasnya tapi pastikan ketika nanti publish di transpile dulu ke ES5.
Jika divideo atas ada scene untuk unit tes, itu sebenarnya tidak wajib ya, tapi diusahakan ada karena memang penting sekali. Terutama untuk debuging, atau ketika mulai banyak developer lain yang ingin berkontribusi, unit test untuk memastikan seluruh fitur di package buatanmu tidak melenceng jauh dari ekspetasi dan tentunya mencegah bug ketika dipakai developer lain.
Waktunya Publikasi
Sebelum lanjut, pastikan kamu telah memiliki akun di https://npmjs.org , karena disanalah package ini akan bernaung.
Setelah akun telah berhasil terdaftar, lanjutkan dengan login NPM di perangkat kamu, melalui terminal, dengan command :
npm adduser
Sisanya masukan username, password dan public email kamu.
Setelah ada tampilan login sukses, saatnya untuk publikasi, gunakan command :
npm publish
JIka tidak ada masalah, maka setelah eksekusi command diatas maka secara resmi kamu telah memiliki NPM package sendiri.
Update Package
Perintah untuk publikasi baru dan update sebenarnya sama, yaitu
npm publish
Tapi perlu perubahan di package.json agar package kamu bisa menerima update, yaitu perubahan pada property version di package json.
"version": "0.0.2",
Pastikan versionnya tidak sama dengan yang sudah pernah kamu publikasi di npmjs.com
Hapus Package
NPM memberlakukan aturan ketat disini, karena ini selain berhubungan dengan pembuat package, juga berhubungan dengan pengguna package. Berikut aturan yang berlaku unpublish alias hapus package di NPM hanya berlaku 72 jam sejam package tersebut dirilis. Jika lebih dari itu maka hanya bisa set status menjadi deprecated alias kadaluarsa, sumber : https://docs.npmjs.com/cli/unpublish .
Command untuk menghapusnya adalah
npm unpublish [<@scope>/]<pkg>[@<version>]
Penutup
Nah menarik bukan, ini adalah salah satu cara menarik untuk kontribusi didunia open source, buat package se unik mungkin, pastikan pula kodenya seefisien dan seefektif mungkin, selamat berkarya.
Originally published at https://academy.byidmore.com.