गिट के अंदर परिवार का पेड़

हैप्पी प्रोग्रामर डे! मैं चाहता हूं कि आप अधिक उज्ज्वल हंगामा, मर्ज किए गए पुल अनुरोध, कम मर्ज संघर्ष और आपकी जीवन शाखाएं यथासंभव लंबे समय तक प्रासंगिक रहें। एक वैचारिक उपहार के रूप में, मैं Git संस्करण नियंत्रण प्रणाली के माध्यम से एक परिवार के पेड़ के कार्यान्वयन का प्रस्ताव करता हूं। खैर ... एक योजना की तरह लगता है!

उन लोगों के लिए जिन्होंने तुरंत सब कुछ समझ लिया है, मैं स्रोत कोड के लिंक देता हूं: वंशावलीट्रीइनगिट और परिवार के पेड़: मेरा और अमेरिकी राष्ट्रपति ।

इसके अलावा, मैंने एक सरल सामाजिक ग्राफ लागू किया। यह न केवल रिश्तेदारी की डिग्री प्रदर्शित करता है, बल्कि वंशजों, शादी, तलाक, प्रसव जैसी घटनाओं के साथ-साथ संबंधों में योगदान की स्थिति भी बताता है।

Git

आपको याद दिला दूं कि Git सबसे लोकप्रिय संस्करण नियंत्रण प्रणालियों में से एक है। यह शक्तिशाली है: आप परिवर्तन कर सकते हैं, (चेकआउट) बना सकते हैं और शाखाओं को मर्ज कर सकते हैं, फाइलों के अलग-अलग संस्करणों की तुलना कर सकते हैं (विस्‍तारित), विशिष्ट तारों के लेखकों की पहचान करें (दोष), और कई अन्य चीजें करें।

सौभाग्य से या दुर्भाग्य से, Git उस विजेता के समान है जो इतिहास को फिर से लिखता है: यह आपको तारीखों, संदेशों और commits के लेखकों को बदलने की अनुमति देता है। लेकिन यह आपको परिवार के सदस्यों को जोड़ने की अनुमति देता है, जैसे कि वे किसी विशिष्ट तिथि पर किए गए घटनाओं के लेखक हैं।

मैंने छोटी शुरुआत की: मैंने कई कमांड और वॉइला लिखा, पेड़ का एक टुकड़ा तैयार है। ठीक। अब हम रिश्तेदारों की पूरी सेना के साथ ऐसा करने जा रहे हैं। मुझे उनके लिए भ्रमित करने वाली कोड की 200 लाइनें, और राष्ट्रपतियों के लिए 10K लाइनें लिखने में खुशी होगी!

क्या आपने मुझे पहले ही बेवकूफों की सूची में जोड़ दिया है? मारपीट बंद। बेशक, मैंने इस प्रक्रिया को स्वचालित कर दिया और वंशानुगत डेटा को गीट कमांड के अनुक्रम में परिवर्तित करने के लिए एक आवेदन लिखा। इस तरह के डेटा के लिए कई प्रारूप हैं, मैंने GEDCOM को चुना।

GEDCOM

GEDCOM वंशावली डेटा के आदान-प्रदान के लिए एक विनिर्देश है। यह प्रारूप बहुत पुराना है, लेकिन सरल है। विनिर्देश इंटरनेट पर अच्छी तरह से वर्णित है । यह लगभग सभी वंशावली कार्यक्रमों द्वारा समर्थित है, इसलिए इसके कई उदाहरण हैं: अमेरिकी राष्ट्रपति, शाही राजवंश, शेक्सपियर।

मैंने यह सारी गड़बड़ी .NET कोर में लागू की है - यह सुविधाजनक और क्रॉस-प्लेटफॉर्म है। GEDCOM को पार्स करने और संसाधित करने के लिए, कई C # लाइब्रेरी हैं, उदाहरण के लिए, GeneGenie.Gedcom , gedcomx-csharp । मैंने अपना खुद का पुस्तकालय GedcomParser पर आधारित लिखने का फैसला किया, क्योंकि इसका एक घातक दोष है ... वास्तव में, नहीं: मैं सिर्फ प्रारूप को समझना चाहता था और सभी निर्भरता से छुटकारा चाहता था, जो कि यदि आवश्यक हो, तो आसानी से परियोजना को पोर्ट करने की अनुमति देता है अन्य भाषाएं।

कमांड जनरेशन

यह एक सुविधाजनक प्रारूप में निकाले गए डेटा को संसाधित करने और इसके लिए Git कमांड उत्पन्न करने का समय है। मैंने सभी घटनाओं को कालानुक्रमिक क्रम में क्रमबद्ध करने का फैसला किया, और फिर शाखाओं का निर्माण, विलय और तारीखों के बढ़ते क्रम में उन्हें प्रतिबद्ध किया। दुर्भाग्य से, सभी घटनाओं की तारीखें नहीं हैं, इसलिए सभी घटनाओं को सही ढंग से क्रमबद्ध करना आसान नहीं था। 2 ^ 2 ^ 3 दिन का समय आ रहा है, और मुझे एहसास हुआ कि यह दृष्टिकोण पूरी तरह से सही नहीं था, क्योंकि गहराई-पहली खोज बहुत आसान होगी। शायद मैं इसे बाद में सही करूंगा।

प्रारंभ

इस स्तर पर हम केवल भंडार को प्रारंभिक करते हैं:

mkdir Family cd Family git init 

घटनाक्रम

स्क्रिप्ट के इस भाग में हम सभी घटनाओं को संसाधित करते हैं और करते हैं। ऐसा करने के लिए, निम्न आदेशों का उपयोग किया गया था:

• git checkout --orphan branch_name
• git merge @I1@ --allow-unrelated-histories --no-commit
• git commit -m "msg" --date "" --author "name <email>" --allow-empty

पहला कमांड, checkout , प्रत्येक व्यक्ति के लिए एक शाखा बनाता है। - --orphan ध्वज आपको अनाथ शाखाएं बनाने की अनुमति देता है, अर्थात् माता-पिता के बिना शाखाएं। अनाथ शाखा एक बार बनाई जाती है - अगली बार जब आप checkout कमांड का उपयोग करके शाखाओं को स्विच करते हैं तो यह पैरामीटर छोड़ दिया जाता है। अंत में, लगभग सभी कमेंट्स में माता-पिता होते हैं, सबसे दूर के पूर्वजों को छोड़कर, जैसा कि पहले वाले अज्ञात थे।

दूसरी आज्ञा, merge , माता-पिता को एकजुट करती है और बच्चे को पैदा करती है। हम प्रतिबद्ध संदेश में संबंधित वर्ष के साथ "जन्म" लिखते हैं। हम अनाथ शाखाओं को मर्ज करने और बाद में परिवर्तन करने के लिए झंडे - --allow-unrelated-histories और --no-commit भी निर्दिष्ट करते हैं। कुछ बच्चों को गोद लिया जाता है, इसलिए हम उनके लिए "एडॉप्टेड" लिखते हैं। मजेदार, लेकिन Git सामूहिक विवाह की अनुमति देता है, यानी एक बार में दो से अधिक शाखाओं का विलय करना संभव है। और शाखाओं में लिंग नहीं है, इसलिए आप उन्हें "माता-पिता 1" और "माता-पिता 2" कह सकते हैं। वैसे, एकल माता-पिता बनाना भी संभव है।

अंत में, तीसरी आज्ञा, commit , संदेश के साथ एक नई प्रतिबद्ध बनाता है -m , दिनांक - दिनांक और लेखक --author । जैसा कि मैंने पहले ही उल्लेख किया है, Git आपको संदेश, लेखक और प्रतिबद्ध की तारीख को बदलने की अनुमति देता है। इसके अलावा, Git आपको फ्लैग के साथ फ़ाइलों के बिना कमिट बनाने की अनुमति देता है --allow-empty और फ्लैग के साथ संदेशों के बिना --allow-empty-message । लेखक को एक ईमेल निर्दिष्ट करने की आवश्यकता है, लेकिन गिट एक खाली को स्वीकार करता है - आपको बस <> लिखना होगा। दुर्भाग्य से, Git बुजुर्गों का सम्मान नहीं करता है: प्रतिबद्ध होने की तारीख की निचली सीमा 1 जनवरी, 1970 (यूनिक्स समय की "शुरुआत") है - पहले की तारीख गलत तरीके से प्रदर्शित की जाएगी। हालाँकि, आप वर्णन में वास्तविक तिथि का उल्लेख कर सकते हैं। फिर भी, Git भविष्य में तारीखों को स्वीकार करता है - मेरे बेटे Git को देखें। वैसे, एकल माता-पिता बनाना भी संभव है।

सामाजिक ग्राफ

सामाजिक ग्राफ में, जन्म के अलावा अन्य घटनाओं को भी संग्रहीत किया जाता है: बपतिस्मा, निवास का परिवर्तन, स्नातक, विवाह, तलाक, मृत्यु, अंतिम संस्कार। मृत्यु के बाद शाखा डिजिटल स्वर्ग में जाती है शाखा में अंतिम संस्कार को छोड़कर बाद की घटनाओं की उपस्थिति असंभव है। सर्वर पर, आप इस शाखा को संरक्षित कर सकते हैं (चिंता न करें: भविष्य में इसे पुनर्जीवित करना संभव है, यदि आवश्यक हो)।

घटना "वेडिंग" में दो पूर्वजों - पति / पत्नी हैं। "तलाक" के एक पूर्वज हैं - पिछले "शादी"। परिवार और पालन-पोषण काम है, इसलिए हम कह सकते हैं कि शादी के बाद एक नया वंश भी प्रकट होता है- "संबंध" जो एक तलाक (या जीवनसाथी की मृत्यु) के बाद समाप्त होता है। यह अगली शादी के बाद फिर से शुरू होता है। इसके अलावा, कई लोग एक रिश्ते में भाग ले सकते हैं (कई शाखाओं को मिलाते हुए)।

अंतिम रूप

केक पर चेरी: हम एक बैकअप रिपॉजिटरी बनाते हैं और GitHub, GitLab, या Git का समर्थन करने वाले किसी भी अन्य सर्वर पर सभी प्रतिभागियों को अपलोड करते हैं। हम एक-एक करके शाखाओं को धक्का दे सकते हैं, लेकिन जादू कमांड का उपयोग करके हम उन सभी को धक्का देंगे, जो बहुत तेज और सरल है:

 git remote add origin https://gitlab.com/KvanTTT/Family.git git push origin --all -u 

एक सामान्य परिवार के पेड़ को उत्पन्न करने के लिए, आपको जनरेटर शुरू करते समय झंडा --only-birth-events को पारित करने की आवश्यकता होती है। इस मामले में, प्रति व्यक्ति (जन्म) एक प्रतिबद्ध बनाया जाएगा। नहीं तो ए सोशल नेटवर्क सामाजिक ग्राफ उत्पन्न होगा।

उदाहरण

एक छोटे से उदाहरण के रूप में, जो कम से कम हर जगह काम करेगा, मैंने अपना पारिवारिक पेड़ बनाया, और एक बड़ा उदाहरण अमेरिकी राष्ट्रपतियों (2145 लोग) का पेड़ है। वे क्रमशः कोचुरिंस और प्रेसिडेंट्स रिपॉजिटरी में उपलब्ध हैं। अपना खुद का पेड़ बनाने के लिए, मैंने सेवा geni.com का उपयोग किया, जिससे मैंने GEDCOM को पेड़ निर्यात किया। जिस्ट पर एक वंशावली रिपॉजिटरी बनाने के लिए एक उत्पन्न स्क्रिप्ट उपलब्ध है।

GitHub (और GitLab के साथ) पर, आप पूर्वजों और वंश के माध्यम से नेविगेट कर सकते हैं। यह वंशावली विकी सिस्टम फैमिलिपेडिया या वीलेट के समान है । हालांकि, GitHub / GitLab अधिक उन्नत है: पेड़ों को आसानी से इसे डाउनलोड किया जाता है (- --clone कमान की मदद से)। और सबसे महत्वपूर्ण बात, आप एक ही बार में पूरा ग्राफ खोल सकते हैं। (मौजूदा वंशावली कार्यक्रमों में, किसी कारण से, यहां तक ​​कि छोटे रेखांकन भी खोलने में कठिनाइयाँ हैं।) और आप इसे विभिन्न उपकरणों (वेब ​​सेवा, गिट एक्सटेशन , सॉरेकेट्री , गिटक्रैकन और अन्य) का उपयोग करके कर सकते हैं। इसके अलावा, इन सेवाओं का उपयोग अधिकांश वंशावली सेवाओं के विपरीत, मुफ्त में किया जा सकता है।

यह उल्लेखनीय है कि GitHub / GitLab पर भी कुछ प्रकार के विश्लेषिकी उपलब्ध हैं: आप यह पता लगा सकते हैं कि कौन सबसे अधिक है इंस्टाग्राम अकाउंट को फॉलो किया घटनापूर्ण जीवन। या सबसे अधिक सार्वजनिक: Insights टैब लोगों की संख्या कम करने के क्रम में लोगों की एक सूची प्रदर्शित करता है।

दुर्भाग्य से, GitHub और GitLab बड़े पेड़ों को सही ढंग से प्रदर्शित नहीं करते हैं, लेकिन वे ठीक से संग्रहीत होते हैं - आप भंडार और जांच खोल सकते हैं। यहाँ GitLab वेब इंटरफ़ेस में मेरा पेड़ है:

समस्याएं

यह बहुत स्पष्ट नहीं है कि जड़ों से इतिहास को कैसे पूरक किया जाए। अभी के लिए आपको इसे GEDCOM फ़ाइल से शुरू से जनरेट करना होगा। संभवत: यह rebase की मदद से किया जा सकता है-आप कोशिश कर सकते हैं और टिप्पणियों में बता सकते हैं। कोड को "कमिट-ओरिएंटेड" बनाने के लिए इसे फिर से लिखना बेहतर होगा, न कि "इवेंट-ओरिएंटेड", क्योंकि यह अधिक Git-like है: वास्तव में, शाखा एक अलग इकाई नहीं, कमिट का एक क्रम है। मैंने टैग और सबमॉडल्स को लागू करने के बारे में भी सोचा, लेकिन अब मुझे नहीं पता कि इसे बेहतर कैसे करना है।

निष्कर्ष

यदि आप डेवलपर्स के लिए परिवार के पेड़ों को वेब सेवाओं के लिए आगे बढ़ाते हैं, तो उन मुद्दों का उपयोग करके आप वैश्विक कार्य बना सकते हैं और उन्हें मील के पत्थर के अनुसार वितरित कर सकते हैं: बचपन, युवा, वयस्कता, वृद्धावस्था।

परिवार के पेड़ों के अलावा, आप Git का उपयोग प्रोग्रामिंग भाषाओं के वंशावली पेड़ों को सांकेतिक शब्दों में बदलना कर सकते हैं (यह और भी geeky है), वाक्यविन्यास के पेड़, और किसी भी पेड़ की संरचनाएं। Git भी ब्राजीलियाई साबुन ओपेरा के पात्रों के बीच संबंध बनाने के लिए गृहिणियों के लिए उपयोगी हो सकता है :)

व्यावहारिक लाभ: यह वार्म-अप वंशावली डेटा का वर्णन करने के लिए गिट की संरचना, इसके आदेशों और GEDCOM प्रारूप को बेहतर ढंग से समझने में मदद करता है।

लेख के स्रोत GitHub पर उपलब्ध हैं - यदि आपको कोई गलती मिलती है या कुछ जोड़ना चाहते हैं, तो कृपया अनुरोध भेजें। Habr.com प्रारूप में परिवर्तित करने के लिए, मैं लाइब्रेरी मार्ककोव का उपयोग करता हूं ।