Cpan पर एक मॉड्यूल प्रकाशित करना

मैं cpan.org पर अपने मॉड्यूल के पहले प्रकाशन के अनुभव को साझा करना चाहता हूं । हम मानते हैं कि मॉड्यूल पहले से ही लिखा गया है। मेरे मामले में, यह वीके :: ऐप मॉड्यूल था। यह वितरण को ठीक से बनाने और cpan.org पर प्रकाशित करने के तरीके पर ध्यान केंद्रित करेगा।

मॉड्यूल के प्रकाशन में तीन चरण होते हैं:

• pause.perl.org पर पंजीकरण
• मॉड्यूल वितरण विधानसभा
• मॉड्यूल का नाम पंजीकृत करना और वितरण को सर्वर pause.perl.org पर डाउनलोड करना।

Pause.perl.org पर रजिस्टर करें

Cpan पर मॉड्यूल लोड करने के लिए, एक विशेष सिस्टम pause.perl.org बनाया गया था । हम लिंक का पालन करते हैं, हम एक जटिल पंजीकरण प्रक्रिया से गुजरते हैं। परिणामस्वरूप, हमें pause_id और फ़ॉर्म pause_id@cpan.org का ईमेल मिलता है । पंजीकरण के दौरान आपके द्वारा दर्ज किया गया ईमेल pause.perl.org और cpantesters.org से संदेश प्राप्त करेगा। लेकिन आपके मॉड्यूल के लिए प्रलेखन में यह एक ईमेल के रूप में बिल्कुल pause_id@cpan.org निर्दिष्ट करने के लिए अनुशंसित है। अपने निजी ईमेल में pause_id@cpan.org से एक रीडायरेक्ट को कॉन्फ़िगर करने के लिए, pause.perl.org पर लॉगिन करें, मेनू आइटम "खाता जानकारी संपादित करें" पर जाएं, फ़ील्ड में "गुप्त ईमेल पता" पृष्ठ के बहुत नीचे स्थित रीडायरेक्ट के लिए ईमेल पता दर्ज करें। रेडियो बटन "मेरा गुप्त ईमेल पता" चुनें, सबमिट करें पर क्लिक करें। कुछ घंटों में परिवर्तन प्रभावी हो जाएगा। वैसे, यदि आप इस तरह के रीडायरेक्ट को कॉन्फ़िगर नहीं करते हैं, तो आप अपने cpan खाते को अद्भुत metacpan.org सेवा से लिंक नहीं कर पाएंगे , बाँधने के लिए इसे आपके pause_id की आवश्यकता होती है जिससे यह एक सक्रियण पत्र भेजता है।

वितरण का निर्माण

इस प्रक्रिया को स्वचालित करने के लिए कई उपकरण हैं। यहाँ इस लेख में उनमें से अधिकांश का वर्णन किया गया है।

मैंने ExtUtils का विकल्प चुना: मॉड्यूलमेकर। हम एक छोटा सा make_module.pl स्क्रिप्ट लिखते हैं:

#!/usr/bin/perl use ExtUtils::ModuleMaker; $mod = ExtUtils::ModuleMaker->new( NAME => 'VK::App', ABSTRACT => 'Creation client applications for vk.com', VERSION => '0.01', LICENSE => 'perl', # You can choose one of the standard licenses by includin BUILD_SYSTEM => 'ExtUtils::MakeMaker', NEED_POD => '0', # Include POD section in *.pm files created. (Default is on NEED_NEW_METHOD => '0', # Include a simple new() method in the *.pm files cr INCLUDE_TODO => '0', INCLUDE_SCRIPTS_DIRECTORY => '1', AUTHOR => 'Misha Genaev', EMAIL => 'mag@cpan.org', CPANID => 'MAG', WEBSITE => 'http://genaev.com', FIRST_TEST_NUMBER => '1', ); $mod->complete_build(); 

हमने इसे कुछ प्रकार की अस्थायी निर्देशिका में रखा और इसे चलाया। यह हमारे वितरण के लिए एक खाका तैयार करता है। इसके बाद, वितरण के लिए एक निर्देशिका बनाएं। यदि मॉड्यूल का नाम VK :: App है और इसका संस्करण 0.01 है, तो निर्देशिका को VK-App-0.01 कहा जाना चाहिए। उसके बाद, टेम्पलेट को VK-App-0.01 पर कॉपी करें और टेम्पलेट App.pm को वास्तविक के साथ बदलें।

 $ perl make_module.pl $ mkdir VK-App-0.01 $ cp -r VK/App/* VK-App-0.01 $ cp real/App.pm VK-App-0.01/lib/VK 

दूसरों पर आपके मॉड्यूल की निर्भरता Makefile.PL में निर्दिष्ट है।

 PREREQ_PM => { 'Test::Simple' => 0.44, 'LWP' => 5.834, 'LWP::Protocol::https' => '0', 'JSON' => 2.53, }, 

मेरे पास इनमें से केवल दो थे: LWP और JSON। परीक्षण :: वितरण टेम्पलेट उत्पन्न होने पर सरल स्वचालित रूप से वहां जोड़ा जाता है। मॉड्यूल का संस्करण कमांड द्वारा पाया जा सकता है:

 $ perl -MLWP -e 'print "$LWP::VERSION\n"' $ perl -MJSON -e 'print "$JSON::VERSION\n"' 

यदि कोई संस्करण उपयुक्त है, तो Makefile.PL में 0 निर्दिष्ट किया गया है।

सभी वितरण तैयार है। आपको इसे पैक करने की आवश्यकता है और आप प्रदर्शन की जांच कर सकते हैं।

 $ tar -czf VK-App-0.01.tar.gz VK-App-0.01 $ cd VK-App-0.01 $ perl Makefile.PL $ make $ make test 

मॉड्यूल नाम पंजीकृत करें और वितरण डाउनलोड करें

एक मॉड्यूल प्रकाशित करने में एक महत्वपूर्ण कदम इसके नाम को पंजीकृत करना है। ऐसा करने के लिए, "रजिस्टर नामस्थान" में pause.perl.org पर जाएं और ध्यान से सभी फ़ील्ड भरें। विशेष रूप से ध्यान "समान कार्यक्षमता वाले मॉड्यूल" और "राशनेल" फ़ील्ड पर दिया जाना चाहिए। पहला समान मॉड्यूल के नामों को सूचीबद्ध करना है। दूसरे में, विस्तार से बताएं कि आपका मॉड्यूल दूसरों से कैसे भिन्न है और इसे वही कहा जाना चाहिए जिसे आपने इसे कहा है।

उसके बाद, "CPAN पर फ़ाइल अपलोड करें" पर जाएं, वहां हमारे VK-App-0.01.tar.gz संग्रह को अपलोड करें और प्रतीक्षा करें। मेरे मामले में, मॉड्यूल एक दिन बाद cpan.org पर दिखाई दिया।