💺 🐇 ☺️ गिट के साथ अर्ध-स्वचालित संस्करण 🤳🏿 👟 👩🏻‍🎓

एक ही समय में विभिन्न रिपॉजिटरी में कई बार जीथब पर चलते हुए मैंने "v2.3.4" जैसे टैग देखे और "बम्प संस्करण" जैसे संदेशों के साथ काम करता है और वर्जन संख्याओं को कहीं लिब / वर्जन में बदल रहा है। और यह हमेशा मुझे लगता था - कुछ बहुत ही शानदार था।

और जब संस्करण संख्या निर्धारित करने के बारे में सोचने का समय आया, तो मैंने कहा: “नहीं! मैं इन नंबरों को हाथ से फाइलों में नहीं लिखूंगा। मेरे संस्करण नियंत्रण प्रणाली को मेरे लिए करने दें! "

इसलिए, जैसा कि मैं इसे देखता हूं:

संस्करण संख्या संख्याओं के एक ट्रिपल की तरह दिखती है: major.minor.patch संस्करण और संस्करण असाइनमेंट की तर्कसंगत नीति के अनुसार बढ़ जाती है;
प्रत्येक नए मामूली संस्करण को जारी करते समय, इतिहास में एक निश्चित कमिटमेंट के लिए, मैं फॉर्म वी <मेजर> <माइनर> का टैग बनाता हूं;
Git मुझे स्वचालित रूप से अंतिम टैग (इस कमिट के लिए) के आधार पर संस्करण संख्या और उसके बाद आने वाले नंबर देगा।

यह कैसे काम करता है:

Git में कई उपयोगी कमांड हैं, हम दो में रुचि लेंगे:

git describe - इस प्रतिबद्ध से उपलब्ध सबसे नवीनतम टैग के बारे में जानकारी दिखाता है;
git show - विभिन्न प्रकार की वस्तुओं को प्रदर्शित करता है (लेकिन हम केवल वर्तमान प्रतिबद्ध में रुचि रखेंगे)।

इस ज्ञान के साथ सशस्त्र, मैंने कॉन्फ़िगरेशन / इनिशियलाइज़र फ़ोल्डर में मेरी रेल परियोजना में निम्न सामग्री का version.rb फ़ाइल रखा:

 module AppName module Version Described = (IO::popen('git describe --long') { |gs| gs.read }).strip Number = Described.gsub('-', '.').gsub(/^v/, '').split('.')[0..-2].join('.') Date = Date.strptime( IO::popen('git show -s --format="%ct"') { |gs| gs.read } , "%s") Revision = (IO::popen('git show -s --format="%H"') { |gs| gs.read }).strip end end

यहाँ निम्नलिखित होता है:

git describe --long निम्नलिखित के समान संदेश प्रदर्शित करता है: v0.8-3-g387f83f , जहाँ

v0.8 - टैग नाम
3 - इस टैग के बाद कमिट की संख्या (0 यदि टैग वर्तमान कमेंट पर सेट है)
387f83f - वर्तमान प्रतिबद्ध का एक छोटा हैश।

यह पंक्ति Described.gsub('-', '.').gsub(/^v/, '').split('.')[0..-2].join('.') इस संदेश की ओर जाता है Described.gsub('-', '.').gsub(/^v/, '').split('.')[0..-2].join('.') 0.8.3

git show -s --format="%ct" हमें वह दिनांक मिलती है, जब वर्तमान कमेंट यूनिक्स प्रारूप में बनाया गया था।

और git show -s --format="%H" हमें पूर्ण प्रतिबद्ध हैश लौटाता है।

परिणाम

अब, जब आवेदन शुरू होता है, तो वर्तमान संस्करण संख्या और रिलीज की तारीख हमारे लिए स्वचालित रूप से उपलब्ध है। और अब, पृष्ठ पर कहीं हम लिख सकते हैं:

 " AppName.  #{AppName::Version::Number}  #{I18n.l AppName::Version::Date, :format => :long} ."

और मिलता है

 " AppName.  0.8.3  27  2012 ."

पेशेवरों और विपक्ष

आकर्षण आते हैं

अब आपको वर्जन नंबरों पर कम स्टीम लेना है, और केस "आह, लानत है, वर्जन नंबर को बढ़ाना भूल गया है!" अब कम होगा (आखिरकार, माइनर और मेजर वर्जन हर दिन, सही नहीं निकलते हैं?);
(पिछले पैराग्राफ के परिणामस्वरूप) रिपॉजिटरी और कोड में संस्करण संख्याओं की असंगति की संभावित संभावना समाप्त हो जाती है (कोड में अधिक नहीं हैं);
निर्माण प्रक्रिया के भाग के रूप में संकलित कार्यक्रमों (C ++) के लिए आदर्श।

विपक्ष

यह रिपॉजिटरी के बाहर काम नहीं करेगा (और कौन और क्यों रिपॉजिटरी के बाहर कोड रखने के लिए जा रहा था?);
संस्करण पैच नंबर (दूसरी ओर, कोड की प्रत्येक पंक्ति पर प्रतिबद्ध नहीं है) के लिए दृढ़ता से लिंक की संख्या को लिंक करें;
कभी-कभी संस्करण संख्या को अभी भी कठिन रूप से वर्तनी की आवश्यकता होती है;
यह उदाहरण के लिए, PHP के लिए उपयुक्त नहीं है, क्योंकि यह प्रत्येक अनुरोध के लिए तीन शेल-कमांड के एक जोड़े को कॉल करने के लिए लाभहीन है।

क्या पढ़ना है?

खैर, सबसे पहले, git वर्णन और git मैनुअल दिखाते हैं ।

सामान्य तौर पर, "<CVS> ऑटोवोवर्डिंग" (जहां <CVS> आपके पसंदीदा संस्करण नियंत्रण प्रणाली का नाम है) पर एक खोज आपको किसी भी अवसर, कार्यक्रम या प्रौद्योगिकी के लिए व्यंजनों की एक बड़ी संख्या प्रदान करेगी।

पुनर्स्थापना क्रम में अच्छा भाग्य (कम से कम संस्करणों में)।

गिट के साथ अर्ध-स्वचालित संस्करण