Cara Menerbitkan Pakej Golang

Menerbitkan pakej ialah cara yang baik untuk berkongsi alat anda dengan dunia. Seseorang boleh mengimport pakej dan menggunakannya dalam projek mereka, dan mencapai fungsi yang telah anda bina. Agak mudah untuk menerbitkan pakej Golang berbanding bahasa lain. Kami akan melakukannya dalam blog ini. Saya baru-baru ini menerbitkan pakej GenCLI saya, anda boleh menyemaknya di sini.

Untuk tujuan demo, saya ada projek CLI ini. CLI berkuasa AI ini. Ia memberikan anda jawapan kepada soalan anda melalui terminal, dibina dengan Cobra dan API Google Gemini. Kini projek ini adalah tempatan, dan satu-satunya cara untuk menjalankannya ialah pergi ke Root projek dan pergi jalankan main.go dan kemudian gunakan sub-perintah. Ia akan berfungsi dengan baik, tetapi isu di sini ialah ini tidak boleh dipercayai, setiap kali, kita perlu pergi ke akar projek dan menjalankannya, idealnya, ia harus dijalankan dari mana-mana sahaja pada komputer, sama seperti alat CLI yang lain. Selain itu, tidak semua orang akan melakukan kerumitan ini untuk menggunakannya. Jadi, inilah sebabnya mengapa perlu, serta penting untuk menerbitkan alatan.

Terdapat pelbagai cara untuk menamakan pakej anda, tetapi kerana kami akan mengehoskannya di GitHub, kami akan menggunakan cara GitHub. Pastikan dalam fail go.mod anda, nama modul anda ialah konvensyen berikut - github.com//, sama seperti di bawah.

Satu perkara yang perlu diberi perhatian ialah modul tersebut merupakan koleksi Pakej. Kami biasanya mengatakan Menerbitkan Modul Bukan Pakej, tetapi untuk menjadikannya mudah, kami mengekalkannya seperti itu.

module github.com/Pradumnasaraf/go-ai

go 1.22

require (
....
....
....

)

Sekarang setelah semuanya ditetapkan, tolak kod anda ke GitHub. Pastikan, anda menolak kod ke nama pengguna GitHub dan nama repo yang sama yang anda nyatakan dalam modul.

Sebaik sahaja anda menolak kod ke GitHub kini tiba masanya untuk menerbitkan pakej anda, tetapi sebelum anda melakukannya, berikut ialah beberapa amalan terbaik yang perlu anda ikuti

• Lesen: Mempunyai lesen dan cuba letakkan sekatan minimum padanya supaya mudah digunakan, diubah suai dan diedarkan semula.

• Dokumentasi: Kita boleh mengulas di bahagian atas fail pakej untuk menerangkan fungsi dan golang mengambil ini sebagai dokumentasi pakej umum dan menunjukkannya di bawah bahagian dokumentasi Pakej.

• Teg: Teg adalah bagus apabila seseorang mempunyai versi pakej tertentu dan versi yang ditag memberikan hasil yang boleh diramal semasa binaan. Tag hendaklah mengikut Semver. Selain itu, cuba keluarkan versi stabil dengan 1.0.0 dan ke atas, ini memberikan keyakinan kepada pembangun.

Sekarang untuk menerbitkan pakej pergi ke URL https://pkg.go.dev/github.com/. Dalam kes saya, ia adalah https://pkg.go.dev/github.com/Pradumnasaraf/go-ai. Apabila anda melawat, anda akan melihat butang permintaan; klik pada itu untuk meminta penambahan pakej ke pkg.go.dev. Saya tidak akan kerana saya tidak mahu menerbitkan alat ini kerana ia hanya untuk demo.

Sebaik sahaja anda selesai, selepas beberapa jam, ia akan berada di tapak web. Setelah ia disiarkan secara langsung, anda boleh memuat turun CLI dengan menggunakan arahan go install:

go install <repo-url>
go install github.com/Pradumnasaraf/go-ai@latest

Itu sahaja untuk blog ini. Saya gembira anda masih membaca dan berjaya juga. terima kasih! Saya kadang-kadang berkongsi tips di Golang di Twitter. Anda boleh berhubung dengan saya di sana.

Atas ialah kandungan terperinci Cara Menerbitkan Pakej Golang. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!