"إذا أراد العامل أن يؤدي عمله بشكل جيد، فعليه أولاً أن يشحذ أدواته." - كونفوشيوس، "مختارات كونفوشيوس. لو لينجونج"
الصفحة الأمامية > برمجة > كيفية نشر حزمة Golang

كيفية نشر حزمة Golang

تم النشر بتاريخ 2024-11-08
تصفح:649

يعد نشر الحزمة طريقة جيدة لمشاركة أداتك مع العالم. يمكن لأي شخص استيراد الحزمة واستخدامها في مشروعه وتحقيق الوظيفة التي قمت بإنشائها. من السهل جدًا نشر حزمة Golang مقارنة باللغات الأخرى. سنفعل ذلك في هذه المدونة. لقد قمت مؤخرًا بنشر حزمة GenCLI الخاصة بي، يمكنك التحقق منها هنا.

لأغراض العرض التوضيحي، لدي مشروع CLI هذا. هذا CLI المدعوم بالذكاء الاصطناعي. فهو يوفر لك الإجابات على أسئلتك عبر المحطة، التي تم إنشاؤها باستخدام Cobra وGoogle Gemini API. الآن أصبح هذا المشروع محليًا، والطريقة الوحيدة لتشغيله هي الانتقال إلى جذر المشروع وتشغيل main.go ثم استخدام الأوامر الفرعية. سيعمل بشكل جيد، لكن المشكلة هنا هي أن هذا غير موثوق، في كل مرة، نحتاج إلى الانتقال إلى جذر المشروع وتشغيله، ومن الناحية المثالية، يجب تشغيله من أي مكان على الكمبيوتر، تمامًا مثل أدوات واجهة سطر الأوامر الأخرى. بالإضافة إلى ذلك، لن يقوم الجميع بهذا القدر من المتاعب لاستخدامه. ولهذا السبب من الضروري والمهم أيضًا نشر الأدوات.

يمكن أن تكون هناك طرق متعددة لتسمية الحزمة الخاصة بك، ولكن بما أننا سنستضيفها على GitHub، فسوف نستخدم طريقة GitHub. تأكد من أن اسم الوحدة الخاص بك في ملف go.mod الخاص بك هو الاصطلاح التالي - github.com//، تمامًا كما هو موضح أدناه.

هناك شيء واحد يجب ملاحظته وهو أن الوحدة عبارة عن مجموعة من الحزم. نحن نقول عمومًا إن نشر الوحدة وليس الحزم، ولكن لإبقاء الأمر بسيطًا، أبقينا الأمر بهذه الطريقة.

module github.com/Pradumnasaraf/go-ai

go 1.22

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

)

الآن بمجرد ضبط كل شيء، ادفع الكود الخاص بك إلى GitHub. تأكد من دفع الكود إلى نفس اسم مستخدم GitHub واسم الريبو الذي ذكرته في الوحدة.

بمجرد إرسال الكود إلى GitHub، حان الوقت لنشر الحزمة الخاصة بك، ولكن قبل القيام بذلك، إليك بعض أفضل الممارسات التي يجب عليك اتباعها

  • الترخيص: احصل على ترخيص وحاول وضع الحد الأدنى من القيود عليه بحيث يمكن استخدامه وتعديله وإعادة توزيعه بسهولة.

  • الوثائق: يمكننا التعليق في الجزء العلوي من ملف الحزمة لشرح الوظيفة وجولانج يأخذ هذا كوثائق عامة للحزمة ويظهره ضمن قسم وثائق الحزمة.

  • ]
  • العلامات: يكون وضع العلامات أمرًا جيدًا عندما يكون لدى الشخص إصدار معين من الحزمة، كما توفر الإصدارات ذات العلامات نتائج يمكن التنبؤ بها أثناء عمليات الإنشاء. يجب أن تتبع العلامات Semver. حاول أيضًا إصدار إصدارات مستقرة بإصدار 1.0.0 وما فوق، فهذا يمنح المطورين الثقة.

الآن لنشر الحزمة توجه إلى عنوان URL https://pkg.go.dev/github.com/. في حالتي، سيكون https://pkg.go.dev/github.com/Pradumnasaraf/go-ai. عند زيارتك، سترى زر طلب؛ انقر فوق ذلك لطلب إضافة الحزمة إلى pkg.go.dev. لن أفعل ذلك لأنني لا أرغب في نشر هذه الأداة لأنها كانت مجرد عرض توضيحي.

How to Publish a Golang Package

بمجرد الانتهاء، بعد بضع ساعات، سيكون على الموقع. بمجرد نشره، يمكنك تنزيل واجهة سطر الأوامر (CLI) باستخدام أمر go install:

go install 
go install github.com/Pradumnasaraf/go-ai@latest

هذا كل شيء بالنسبة لهذه المدونة. أنا سعيد لأنك لا تزال تقرأ وفعلت ذلك أيضًا. شكرًا لك! أقوم أحيانًا بمشاركة النصائح حول Golang على Twitter. يمكنك التواصل معي هناك.

بيان الافراج تم نشر هذه المقالة على: https://dev.to/pradumnasaraf/how-to-publish-a-golang-package-i12?1 إذا كان هناك أي انتهاك، يرجى الاتصال بـ [email protected] لحذفه
أحدث البرنامج التعليمي أكثر>

تنصل: جميع الموارد المقدمة هي جزئيًا من الإنترنت. إذا كان هناك أي انتهاك لحقوق الطبع والنشر الخاصة بك أو الحقوق والمصالح الأخرى، فيرجى توضيح الأسباب التفصيلية وتقديم دليل على حقوق الطبع والنشر أو الحقوق والمصالح ثم إرسالها إلى البريد الإلكتروني: [email protected]. سوف نتعامل مع الأمر لك في أقرب وقت ممكن.

Copyright© 2022 湘ICP备2022001581号-3