इस प्रोजेक्ट के बारे में

Driver Validation Suite, ADBC (Arrow Database Connectivity) ड्राइवरों के सत्यापन के लिए एक पुनः प्रयोग योग्य, प्लग करने योग्य परीक्षण फ़्रेमवर्क है, जो Python और pytest परीक्षण लाइब्रेरी से बनाया गया है। यह लक्ष्य ड्राइवरों के विरुद्ध SQL क्वेरी चलाकर विभिन्न ADBC फ़ीचरों और डेटा प्रकारों का अभ्यास करता है, और दस्तावेज़ तालिकाएँ उत्पन्न करता है जो समर्थित और असमर्थित फ़ीचरों की सूची देती हैं। यह सूट डेटाबेस-विशिष्ट सिंटैक्स और व्यवहार संबंधी विचित्रताओं को समायोजित कर सकता है। परीक्षण केस queries/base निर्देशिका के अंतर्गत व्यवस्थित होते हैं, जहाँ प्रत्येक व्यक्तित परीक्षण में एक ही निर्देशिका की वे सभी फ़ाइलें शामिल होती हैं जिनका आधार फ़ाइलनाम समान होता है। सूट तीन मुख्य क्वेरी प्रकारों का समर्थन करता है: 1. SELECT क्वेरी: क्वेरी चलाने और उसके परिणाम को सत्यापित करने का परीक्षण, जिसमें query.sql फ़ाइल, अपेक्षित परिणाम स्कीमा (query.schema.json), JSON Lines में अपेक्षित परिणाम डेटा (query.json), साथ ही वैकल्पिक setup SQL, bind parameter data, bind schema, और bind query फ़ाइलें शामिल होती हैं। 2. Schema क्वेरी: क्वेरी को निष्पादित किए बिना उसके परिणाम सेट स्कीमा को प्राप्त करने का परीक्षण, जिसके लिए केवल query.sql और अपेक्षित schema फ़ाइल आवश्यक होती है। 3. Ingest क्वेरी: Arrow डेटा के बल्क अंतर्ग्रहण के बाद लोड की गई तालिका से क्वेरी करने का परीक्षण, जिसके लिए input schema और data फ़ाइलें आवश्यक होती हैं, साथ ही वैकल्पिक अपेक्षित result schema और data। सभी परीक्षण केस परीक्षण व्यवहार और दस्तावेज़ आउटपुट को नियंत्रित करने के लिए एक वैकल्पिक query.toml मेटाडेटा फ़ाइल शामिल कर सकते हैं: hide फ़्लैग किसी ड्राइवर के लिए परीक्षण को पूरी तरह छोड़ देता है, skip फ़्लैग परीक्षण को दिए गए कारण के साथ असमर्थित के रूप में चिह्नित करता है, sort-keys तुलना से पहले परिणाम सेटों को क्रमबद्ध करने के लिए कॉलम परिभाषित करता है, और tags चेतावनियाँ जोड़ सकते हैं, आंशिक समर्थन चिह्नित कर सकते हैं, या दस्तावेज़ के लिए SQL प्रकार नाम निर्दिष्ट कर सकते हैं। ड्राइवर अपने निर्दिष्ट quirks निर्देशिका में समान सापेक्ष पथ पर फ़ाइलें रखकर ड्राइवर-विशिष्ट समायोजनों के साथ आधार परीक्षण केसों को ओवरराइड कर सकते हैं, जिससे पूरे परीक्षण केसों की नकल करने की आवश्यकता से बचा जाता है। अलग-अलग प्रति-फ़ाइल परीक्षण परिभाषाओं के विकल्प के रूप में, एक ही .txtcase फ़ाइल का उपयोग किया जा सकता है, जिसमें // part: टिप्पणियाँ चिह्नित करती हैं कि कौन-सा अनुभाग किस मूल फ़ाइल प्रकार से मेल खाता है। .txtcase फ़ाइलों को एक ही परीक्षण केस के लिए अलग-अलग फ़ाइलों के साथ मिश्रित नहीं किया जा सकता, क्योंकि इससे परीक्षण खोज त्रुटियाँ होंगी। परियोजना बताती है कि औपचारिक दस्तावेज़ीकरण अभी प्रगति पर है, और उपयोगकर्ताओं को सलाह देती है कि वे validation suite को एकीकृत करना सीखने के लिए मौजूदा ADBC ड्राइवर कार्यान्वयनों का संदर्भ लें।