.NET से 7-ज़िप या मैंने कोडप्लेक्स पर एक ओपन सोर्स प्रोजेक्ट कैसे किया

यह आलेख समान रूप से ब्लॉग ".NET", "ओपन सोर्स" और "मैं पीआर हूं।" उसके बाद। जैसा कि मैंने सामग्री लिखी थी, यह स्पष्ट हो गया था कि इसमें से अधिकांश "ओपन सोर्स" था ... अगर मैंने कोई गलती की है तो कृपया ज्यादा मत मारो।



तो, नीचे एक स्रोत के बारे में एक कहानी है जो कि ओपन सोर्स सेवनजिपस्पार लाइब्रेरी को विकसित करने में डेढ़ साल का अनुभव है, जिसे फरवरी 2009 में कोडप्लेक्स पर पोस्ट किया गया था। यह लाइब्रेरी 7-जिप के ऊपर एक आवरण है जो .NET में उपयोग करना आसान बनाता है।

सेवनजिपशर का उपयोग करना

लाइब्रेरी में दो मुख्य वर्ग हैं - सेवनजिपटेक्स्ट्रेक्टर और सेवनजिपकमप्रेस। पहला उपयोग पैटर्न:

//

using ( var extr = new SevenZipExtractor( @"\\" ))

{

extr.Extracting += DoExtractingEvent();

extr.ExtractArchive( @"\" );

DoFinishEvent();

}



//

var extr = new SevenZipExtractor( @"\\" );

extr.Extracting += DoExtractingEvent();

extr.ExtractionFinished += (s, e) => { DoFinishEvent(); extr.Dispose(); extr = null ; };

extr.BeginExtractArchive( @"\" );



* This source code was highlighted with Source Code Highlighter .

दूसरा उपयोग पैटर्न:

//

var cmpr = new SevenZipCompressor();

cmpr.CompressDirectory( @"\\\" , @"\" );

DoFinishEvent();

cmpr = null ;



//

var cmpr = new SevenZipCompressor();

cmpr.CompressionFinished += (s, e) => { DoFinishEvent(); cmpr = null ; }

cmpr.BeginCompressDirectory( @"\\\" , @"\" );



* This source code was highlighted with Source Code Highlighter .

मैं लेख को सेवेनज़िपशार्प डॉक्यूमेंटेशन में बदलना नहीं चाहता, इसलिए इसकी कुछ विशेषताओं को सूचीबद्ध करें:

• पूर्ण मल्टीथ्रेडिंग समर्थन
• 7-ज़िप द्वारा समर्थित सभी संग्रह प्रारूप
• लाइब्रेरी के लिए असावधानी - कोई कठोर बंधन नहीं
• अनपैकिंग और पैकेजिंग के दौरान बहु-वॉल्यूम अभिलेखागार के लिए समर्थन
• सबसे SFX अभिलेखागार खोलना
• सभी कोड ध्यान से टिप्पणी की

यह सब कैसे शुरू हुआ

फरवरी 2009 में, मुझे उन भुगतान वाली परियोजनाओं में से 7-ज़िप अभिलेखागार के साथ काम करने की आवश्यकता थी, जिन पर मैंने काम किया था। कई दिनों के लिए, मैंने असफल रूप से तैयार पाचन समाधान की खोज की, लेकिन कोडप्रोजेक्ट पर इस लेख से बेहतर कुछ भी नहीं मिला। लेकिन मैंने बहुत सारे पोस्ट पढ़े जहाँ लोगों ने उसकी अनुपस्थिति के बारे में शिकायत की। और फिर, मेरी इच्छा को मुट्ठी में इकट्ठा किया और पाया लेख से शुरू करके, मैं हिम्मत करके आगे बढ़ गया और 7-जिप के ऊपर आवरण के अपने कार्यान्वयन को लिखना शुरू कर दिया। मैंने LGPLv3 लाइसेंस के तहत हाल ही में खोले गए कोडप्लेक्स पर कोड डालने का फैसला किया। सबसे पहले, काम पूरे जोरों पर था, और मैंने हर कुछ दिनों में एक रिलीज़ के बाद रिलीज़ किया (आप इसे डाउनलोड पृष्ठ के "अन्य डाउनलोड" अनुभाग में खुद के लिए देख सकते हैं)। फिर मेरा उत्साह थोड़ा फीका पड़ गया और मैंने कोड को स्थिर करना शुरू कर दिया। सितंबर 2009 में, रिलीज अक्सर बंद हो गई (मेरी शादी हुई) और तब से मैं इस परियोजना का समर्थन करता हूं जितना मैं कर सकता हूं।



7-ज़िप को / असेंबली ध्वज के साथ मिश्रित असेंबली में संकलित करने के विकल्प पर विचार किया गया था। इस विकल्प को अस्वीकार कर दिया गया था सबसे पहले, इंटरफ़ेस निम्न स्तर का होगा और त्वरित उपयोग के लिए उपयुक्त नहीं होगा और फिर भी एक "ऐड-ऑन" लिखना होगा, और दूसरा, / clr: शुद्ध ध्वज के साथ कोड एकत्र करने के लिए, बहुत सारे कोड को फिर से लिखना आवश्यक होगा, और अनवांटेड पार्ट्स अभी भी बने हुए हैं ।



जब सेवनजिपशर पहली बार सामने आया, मैं इसके बारे में संभावित इच्छुक उपयोगकर्ता-डेवलपर्स को बताना चाहता था। जहाँ भी संभव हो, मैंने पुस्तकालय का एक संक्षिप्त विवरण छोड़ दिया: स्टैकऑवरफ़्लो सवालों के जवाब में, प्रोग्रामिंग मंचों (एमएसडीएन, चैनल 9 सहित) में, कोडप्रोजेक्ट पर एक ही लेख और यहां तक कि अंग्रेजी विकिपीडिया में टिप्पणियों में । यह सभी परिणाम निकले, और जल्द ही Google खोज परिणाम ट्रैफ़िक में पहले स्थान पर आ गए। मुझे लगता है कि हर किसी को अपनी परियोजनाओं का विज्ञापन करना चाहिए, अन्यथा बहुसंख्यक को अपने अस्तित्व के बारे में नहीं पता होगा। विज्ञापन प्रदर्शन का अनुमान डाउनलोड और विज़िट के आंकड़ों से लगाया जाता है, जो सार्वजनिक रूप से उपलब्ध है।

सेवनजिपशरप और 7-जिप

जैसा कि बहुत से लोग जानते हैं, 7-ज़िप को C ++ में थोड़ी सी और कुख्यात कोडांतरक फ़ंक्शन के साथ लिखा जाता है जो CRC32 की गणना करता है, जिसे इगोर पावलोव ने x86, x86-64 और ARM के लिए लागू किया था। कोड पर कोई प्रलेखन नहीं है, जो खुले स्रोत आंदोलन में शामिल रूसी प्रोग्रामर की शैली में है। बहुत सारे कोड हैं, यह बिल्कुल सरल नहीं है और परिभाषाओं, इंटरफेस और कक्षाओं की बहुतायत को समझने में कुछ समय लगता है। संपीड़न एल्गोरिदम के कार्यान्वयन को कोडेक्स कहा जाता है। कोडेक को लाइब्रेरी में एक मानक तरीके से बनाया गया है, जैसे कि एएल मिरांडा / पिजिन मार्जिन में प्रोटोकॉल प्लग-इन। 7-ज़िप वास्तुकला COM से अविभाज्य है; यह ठीक वही है जो P7zip के विकास में बाधा डालता है - POSIX सिस्टम के लिए 7-ज़िप, जो कि इगोर पावलोव से भी संबंधित है। P7zip में, COM को एक बैसाखी द्वारा प्रतिस्थापित किया जाता है जो अपने काम को अनुकरण करता है, साथ ही साथ windows.h प्रकार के आधे हिस्से की घोषणा करता है। एल्गोरिदम स्वयं निर्दोष रूप से लिखे गए हैं और बहुत स्थिर हैं, लेकिन ऊपरी स्तर, जैसा कि आप पहले से ही अनुमान लगाते हैं, वांछित होने के लिए बहुत कुछ छोड़ देते हैं। यदि लेखक ने अब 7-ज़िप लिखना शुरू कर दिया है, तो मुझे लगता है कि वह एक अधिक समझदार, सार्वभौमिक और पोर्टेबल कर्नेल वास्तुकला के साथ आएगा, आदर्श रूप से सी # या जावा जैसी भाषा में, भले ही पायथन (अच्छी तरह से, प्लस इस उद्देश्य के लिए उपयुक्त नहीं हैं, जो वास्तव में है) ।



वैसे, अंत उपयोगकर्ताओं के लिए 7-ज़िप (स्थापना, जो 7-zip.org से डाउनलोड होती है) सदी की शुरुआत के विजुअल स्टूडियो 6 नमूने के लिए जा रही है। समाधान फ़ाइलों को सफलतापूर्वक VS2008 / 2010 प्रारूपों में बदल दिया जाता है, और C / C ++ कंपाइलर को एक नए के साथ बदलने और सभी ऑप्टिमाइज़ेशन फ़्लैग को सक्रिय करने के बाद (हाँ, मेरा मुख्य पेशा कंपाइलर है), साथ ही प्रोफ़ाइल का उपयोग करके त्वरण 15% (LZMA / LZMA2) प्राप्त किया जाता है )। ध्यान दें ...



यहाँ बताया गया है कि सेवेनजिपशरप 7-ज़िप को कैसे लपेटता है। COM के CreateObject के माध्यम से, एक ऑब्जेक्ट बनाया जाता है जो निर्दिष्ट इंटरफ़ेस (IInArchive, IOutArchive) का समर्थन करता है। आवश्यक कार्य इस ऑब्जेक्ट से खींचे जाते हैं, और वांछित परिणाम प्राप्त किया जाता है (उदाहरण के लिए, IInArchive.Extract (...))। लंबे ऑपरेशन के दौरान, प्रबंधित कॉलबैक को अनवांटेड कोड से कॉल किया जाता है, और यह एक समस्या की ओर जाता है जिसे मैं तुरंत पहचान नहीं पाया - त्रुटि हैंडलिंग। उदाहरण के लिए, कॉलबैक में कोई त्रुटि या कॉलबैक उपयोगकर्ता इवेंट में अपवाद के कारण, अजीब 32-बिट त्रुटि कोड को छोड़कर, ऑपरेशन चेतावनियों और किसी भी जानकारी के बिना विफल हो जाता है। मैंने सभी कॉलबैक को लपेटने का प्रयास किया और एस / कैच करने की कोशिश की और उन सभी अपवादों को डाल दिया, जिन्हें त्रुटि स्टैक में फेंक दिया गया था, जो विफलता के मामले में उपयोगकर्ता को दिखाया गया है। यदि कोई अधिक सुरुचिपूर्ण समाधान है, तो कृपया इसके बारे में बताएं।



उत्साही लोगों द्वारा सी # में पूरे 7-ज़िप कोड को फिर से लिखने के लिए हैक करने का प्रयास नियमित रूप से किया जाता है, लेकिन चर्चा से परे नहीं गया है। C ++ से C # के एल्गोरिदम का रीमेक बनाना लाभदायक नहीं है: खर्च किए गए प्रयासों और गति में गिरावट से क्रॉस-प्लेटफॉर्म और धर्म का भुगतान नहीं होता है, और केवल इगोर पावलोव ही सभी सूक्ष्मताओं को ध्यान में रखते हुए कर्नेल को फिर से लिख सकते हैं। मैं निराधार नहीं होगा: माप के लिए LZMA SDK से C # /। NET पर LZMA अप्रबंधित एल्गोरिथ्म की तुलना में 4 गुना धीमा काम करता है। इसलिए, शायद इस स्थिति में सबसे अच्छा एक स्पष्ट और सरल इंटरफ़ेस के साथ एक आवरण बनाना था।



एक बिंदु पर, मैं मोनो (जीएनयू / लिनक्स) के तहत काम करने के लिए सेवनजिपस्पार प्राप्त करना चाहता था। और फिर COM को 7-ज़िप लगाव की समस्या ने अपने सभी वैभव में खुद को दिखाया। लाइब्रेरी के निचले स्तर के हिस्से को स्क्रैच से फिर से लिखना आवश्यक था। क्योंकि 7-ज़िप कोड, जैसा कि मैंने पहले ही लिखा है, विशिष्ट है, SWIG की तरह स्वचालित रैपिंग के लिए उपकरण बेकार हो गए हैं, और उन्हें बिल्कुल काम करने के लिए, मुझे पहले एक प्रीप्रोसेसर के साथ पूरे कोड से गुजरना पड़ा और 10-स्टोरी डिफाइन को हटाना पड़ा। वर्तमान में, मैं धीरे-धीरे COM-स्वतंत्र आवरण लिख रहा हूं।

डिज़ाइन

शायद, कई सी # नौसिखिए डेवलपर्स एक ही गलतियों को दोहराते हैं, और मैं कोई अपवाद नहीं हूं। जब मुझे FxCop और StyleCop के बारे में पता चला, तो मैंने तुरंत उनका उपयोग करने की कोशिश की। लाइब्रेरी कोड को अच्छी स्थिति में बनाए रखना तर्कसंगत होगा। हालाँकि, डिफ़ॉल्ट स्टाइलकॉप बहुत सारी चेतावनियाँ प्रदर्शित करता है, और मैं इसे कॉन्फ़िगर नहीं करना चाहता था, और इसे तुरंत छोड़ दिया गया था। FxCop का उपयोग कुछ समय के लिए किया गया है, लेकिन एक बिंदु पर मैंने खुद को यह सोचते हुए पाया कि मैं प्राथमिक कोड परिवर्तनों पर बहुत अधिक समय उन नियमों का पालन करता हूं जो अनिवार्य रूप से किसी चीज को प्रभावित नहीं करते हैं। मैंने अपने लिए जो निष्कर्ष निकाला है वह यह है कि ये उपकरण एक व्यक्तिगत प्रोग्रामिंग शैली विकसित करने के लिए महत्वपूर्ण हैं, लेकिन अकेला डेवलपर्स को इसमें शामिल नहीं होना चाहिए।



प्रारंभ में, सेवेनजिपस्पर्प को विजुअल स्टूडियो 2008 में लिखा गया था और द्वितीय ढांचे के तहत काम किया गया था। फिर भी, मैंने महसूस किया कि .NET का संस्करण जितना छोटा होगा, लाइब्रेरी का उपयोग करने में उतनी ही कम समस्याएं होंगी। यह अफ़सोस की बात है कि कई कोडप्लेक्स डेवलपर्स को यह समझ में नहीं आता है, .NET 4 की अल्ट्रा-आधुनिक सुविधाओं का उपयोग करके कोड लिखना शुरू करें और फिर आश्चर्य करें कि उनके पास इतने कम डाउनलोड क्यों हैं। तब मुझे पता चला कि विंडोज मोबाइल <7 में एक पूर्ण-COM है, और कुछ ही दिनों में मैंने इन मोबाइल सिस्टम में सेवेनजिपस्पार पोर्ट कर दिया। यदि कोई नहीं जानता है, तो सामान्य और कॉम्पैक्ट फ्रेमवर्क में कई अंतर हैं, और कोड को मामूली बदलावों के बिना संकलित नहीं किया जाएगा, बहुत कम काम। मैंने इसे दो लगभग समान शाखाओं को बनाए रखने के लिए अनुचित माना, और इस समस्या को एकाधिक # if / # और / # endif (C ++ स्रोतों में मानक दृष्टिकोण) के साथ हल किया।



जब विज़ुअल स्टूडियो 2010 / सी # 4 बाहर आया, तो मैंने पाया कि भाषा के नए संस्करण की विशेषताओं को प्रभावी रूप से कोड पर लागू किया जा सकता है (उदाहरण के लिए, दिखाई दिए गए वैकल्पिक पैरामीटर एक एकल तार्किक विधि के 10+ ओवरलोड को खत्म करते हैं)। पिछड़ी संगतता को बनाए रखने के लिए, मैंने फिर से # if / # और / # endif लागू किया। धीरे-धीरे कोड सुरुचिपूर्ण कक्षाओं और एक शाखा राक्षस से मुड़ना शुरू हुआ। और जब विचार सेवेनज़िपशार्प को मोनो में पोर्ट करने का विचार आया, तब भी मैंने कुछ कोड फाइलें खोलीं, क्योंकि अन्यथा वह कुछ हफ़्ते में यह पता लगाने में सक्षम नहीं होगा। नतीजतन, इसकी सभी महिमा में मुझे एक ही फाइल में विभिन्न प्लेटफार्मों और फ्रेमवर्क का समर्थन करने की समस्या का सामना करना पड़ा। एक उदाहरण:

#if !DOTNET20

/// <summary>

/// Unpacks the whole archive asynchronously to the specified directory name at the specified priority.

/// </summary>

/// <param name="directory">The directory where the files are to be unpacked.</param>

/// <param name="eventPriority">The priority of events, relative to the other pending operations in the System.Windows.Threading.Dispatcher event queue, the specified method is invoked.</param>

#else

/// <summary>

/// Unpacks the whole archive asynchronously to the specified directory name at the specified priority.

/// </summary>

/// <param name="directory">The directory where the files are to be unpacked.</param>

#endif

public void BeginExtractArchive( string directory

#if !DOTNET20

, DispatcherPriority eventPriority

#if CS4

= DispatcherPriority.Normal

#endif

#endif

)

{

SaveContext(

#if !DOTNET20

eventPriority

#endif

);

( new ExtractArchiveDelegate(ExtractArchive)).BeginInvoke(directory, AsyncCallbackImplementation, this );

}



* This source code was highlighted with Source Code Highlighter .

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

बोनस

कोडप्लेक्स पर एक ओपन सोर्स प्रोजेक्ट में भाग लेने से, अप्रत्याशित सुखद आश्चर्य प्रकट हुआ। सबसे पहले, मैंने देखा कि ReSharper के निर्माता JetBrains, स्रोत सॉफ़्टवेयर डेवलपर्स को खोलने के लिए मुफ्त लाइसेंस देता है। मैंने अपनी किस्मत आजमाई और उसे पछतावा नहीं हुआ - उन्होंने मुझे लाइसेंस दिया। ReSharper कोड लिखने के लिए एक अनिवार्य उपकरण साबित हुआ है, और मैं इस पर सभी को सलाह देता हूं। दूसरे, हाल ही में, कोडप्लेक्स प्रोजेक्ट पेजों (अपने मालिकों के अनुरोध पर) पर विज्ञापन दिखाता है। विज्ञापन राजस्व या तो अच्छे उद्देश्यों के लिए बलिदान किया जा सकता है, या खुद को नियुक्त किया जा सकता है। मैंने दूसरा विकल्प चुना, और मुझे प्रति माह लगभग 10 डॉलर मिलते हैं। तीसरा, जब सेवेनजिपशर ने लोकप्रियता हासिल की, तो मुझे सी # /। नेट प्रोग्रामर के लिए उपयोगी उपकरण विकसित करने वाली कंपनियों द्वारा प्रायोजन की पेशकश की जाने लगी, जैसे एनडी पर निर्भर और SciTech .NET मेमोरी प्रोफाइलर। चौथा, डोनेट बटन थोड़ा पैसा लाता है। किसी ने भी अब तक $ 10 से अधिक का दान नहीं किया है, लेकिन यह भी सुखद और उत्तेजक है।



यह उत्साहजनक है कि जब वे पत्र में पुस्तकालय के लिए धन्यवाद देते हैं, तो वे रिपोर्ट करते हैं कि वे इसका उपयोग वास्तविक और बहुत प्रसिद्ध परियोजनाओं (उदाहरण के लिए, स्टार्डॉक) में करते हैं। कभी-कभी मुझे पुस्तकालय में एक साथ काम करना शुरू करने के सुझाव वाले लोगों से पत्र मिलते हैं। एक व्यक्ति आमतौर पर उत्साही होता है, आश्वासन देता है कि एक साथ यह बहुत अच्छा होगा, आदि। उस पत्र में प्रतिक्रिया के बाद, जिसमें मैं लिखता हूं कि मैंने किसी को भी एक बार SVN पासवर्ड नहीं दिया है, मैं पूछता हूं कि वह व्यक्ति क्या कर सकता है, और भविष्य के लिए परियोजना के विकास के लिए अनुमानित योजनाओं का वर्णन करता है, अभी तक किसी ने मुझसे संपर्क नहीं किया है। यह मुझे अजीब लगता है, शायद ऐसे लोगों का मनोविज्ञान मुझे टिप्पणियों में समझाया जाएगा।





निरंतरता के बिना विशिष्ट पत्र



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



रेटिंग छोड़ने वाले लोगों के लिए अलग से मनोरंजक (1 से 5 तक कोडपलेक्स पर सितारे)। जब वे 2 लगाते हैं तो गुस्सा करते हैं और समझाते नहीं हैं। हालाँकि, यह तब भी होता है जब वे 2 डालते हैं और लिखते हैं कि वे कहते हैं कि कुछ भी काम नहीं करता है और लाइब्रेरी आपकी बकवास है। सौभाग्य से, यह शायद ही कभी अन्य लोकप्रिय परियोजनाओं के विपरीत, सेवेनज़िपशर के साथ होता है, जो मुझे यकीन है, ऐसी रेटिंग्स के लायक नहीं हैं।

परिणाम

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



आपका ध्यान देने के लिए धन्यवाद।