गूगल परीक्षण ढांचे (gtest)

जब कोड का परीक्षण के बारे में एक सवाल ही नहीं था, मैं उपयोग को बढ़ावा देने के लिए संकोच नहीं किया :: परीक्षण। क्षितिज की कोशिश की Google परीक्षा की रूपरेखा विस्तार करने के लिए। यह किसी भी मौजूदा बन्स के अलावा, को बढ़ावा देने के विपरीत :: परीक्षण परियोजना फलफूल रहा है। मैं अर्जित ज्ञान साझा करना चाहते हैं। सब जो पूछने के लिए रुचि रखते हैं करने के लिए

महत्वपूर्ण अवधारणाओं

गूगल परीक्षण ढांचे में मुख्य अवधारणा दावा (ज़ोर) की धारणा है। दत्तक ग्रहण सफलता जिनमें से हो सकता है (सफलता), गैर महत्वपूर्ण विफलता (nonfatal विफलता) और गंभीर विफलता (घातक विफलता) की अभिव्यक्ति के परिणाम है। गंभीर विफलता, परीक्षण के अंत का कारण बनता है अन्यथा परीक्षण जारी रहता है। परीक्षण ही बयान का एक संग्रह है। इसके अलावा, परीक्षण सेट (परीक्षण का मामला) में बांटा जा सकता। यदि यह विभिन्न परीक्षणों में प्रयोग की जाने वाली वस्तुओं की मुश्किल कस्टम समूह है, यह एक निर्धारण (स्थिरता) का उपयोग करना संभव है। परीक्षण के संयुक्त सेट एक परीक्षण कार्यक्रम (परीक्षण कार्यक्रम) कर रहे हैं।

इस प्रकार के दावे (दावे)

अनुमोदन, महत्वपूर्ण विफलताओं के झूठ के मामले में पैदा ASSERT_, nonfatal के साथ शुरू - EXPECT_। ऐसा नहीं है कि एक महत्वपूर्ण विफलता के मामले में तुरंत समारोह है, जो एक इनकार बयान पैदा करने के लिए मुलाकात की वापसी से होता है ध्यान में रखा जाना चाहिए। इस बयान में स्मृति या कुछ अन्य परिष्करण की प्रक्रिया में कुछ सफाई कोड है, तो आप एक स्मृति रिसाव हो सकता है।

निम्नलिखित बयानों उपलब्ध हैं (nonfatal ASSERT_ साथ नहीं शुरू करते हैं, और EXPECT_ के साथ):

सरल तर्क

• ASSERT_TRUE (स्थिति);
• ASSERT_FALSE (हालत);

तुलना

• ASSERT_EQ (उम्मीद है, वास्तविक); - =
• (VAL1, val2) ASSERT_NE; - =
• (VAL1, val2) ASSERT_LT; - <
• (VAL1, val2) ASSERT_LE; - <=
• (VAL1, val2) ASSERT_GT; ->
• (VAL1, val2) ASSERT_GE; -> =

तार की तुलना करना

• ASSERT_STREQ (expected_str, actual_str);
• (Str1, str2) ASSERT_STRNE;
• (Expected_str, actual_str) ASSERT_STRCASEEQ; - insensitively
• - insensitively

अपवाद के लिए परीक्षण

• ASSERT_THROW (बयान, exception_type);
• ASSERT_ANY_THROW (कथन);
• ASSERT_NO_THROW (बयान);

चेक विधेय

• ASSERT_PREDN (pred, VAL1, val2, ..., Valn); - एन <= 5
• ASSERT_PRED_FORMATN (pred_format, VAL1, val2, ..., Valn); - पिछले एक के समान काम करता है, लेकिन आपको आउटपुट को नियंत्रित करने की अनुमति देता है

चल बिन्दु की तुलना

• ASSERT_FLOAT_EQ (उम्मीद है, वास्तविक); - गलत तुलना नाव
• ASSERT_DOUBLE_EQ (उम्मीद है, वास्तविक); - गलत तुलना दोगुना
• ASSERT_NEAR (VAL1, val2, abs_error); - VAL1 और val2 के बीच का अंतर abs_error त्रुटि से अधिक नहीं है

कॉल विफलता या सफलता

• सफल ();
• असफल ();
• ADD_FAILURE ();
• ADD_FAILURE_AT ( «FILE_PATH», line_number);

आप अपनी खुद की समारोह रिटर्न कि लिख सकते हैं AssertionResult

::testing::AssertionResult IsTrue(bool foo) { if (foo) return ::testing::AssertionSuccess(); else return ::testing::AssertionFailure() << foo << " is not true"; } TEST(MyFunCase, TestIsTrue) { EXPECT_TRUE(IsTrue(false)); } 

आप StaticAssertTypeEq <T1, T2> () :: परीक्षण का उपयोग कर डेटा के प्रकारों को नियंत्रित कर सकते हैं ::। संकलन T1 और टी 2 के विभिन्न प्रकार यदि एक त्रुटि के साथ किया जाएगा।

बयान में इस्तेमाल किया डेटा द्वारा जारी किए गए बयान की असत्यता हैं। इसके अलावा, आप अपने खुद के टिप्पणी निर्दिष्ट कर सकते हैं:

 ASSERT_EQ(1, 0) << "1 is not equal 0"; 

यह टिप्पणी में विस्तारित वर्ण सेट (wchar_t) का उपयोग करना संभव है, और दावों में तार से संबंधित। इस अंक में UTF-8 एन्कोडिंग में हो जाएगा।

टेस्ट (परीक्षण)

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

 TEST(test_case_name, test_name) { ASSERT_EQ(1, 0) << "1 is not equal 0"; } 

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

आप न केवल परीक्षण के भाग के रूप में बयानों का उपयोग कर सकते हैं, बल्कि उन्हें किसी भी फ़ंक्शन से भी कॉल कर सकते हैं। अनुमोदन, महत्वपूर्ण विफलताओं पैदा करने के लिए एक गैर शून्य समारोह से नहीं कहा जा सकता - सिर्फ एक सीमा है।

फिक्सिंग (जुड़नार)

ऐसा नहीं है कि वस्तुओं के परीक्षण में भाग लेने वाले, मुश्किल प्रत्येक परीक्षा के लिए कॉन्फ़िगर करने के लिए होता है। आप एक समय की स्थापना की प्रक्रिया निर्धारित करने और प्रत्येक परीक्षा के लिए यह स्वचालित रूप से कर सकते हैं। ऐसी स्थितियों में, लॉक का उपयोग।

कमिट एक ऐसी श्रेणी है जिसे विरासत में मिला है :: परीक्षण :: परीक्षण, जिसके अंदर परीक्षण के लिए आवश्यक सभी वस्तुओं को घोषित किया जाता है, जबकि निर्माणकर्ता या सेटअप () फ़ंक्शन में, उन्हें सेट किया जाता है, और संसाधन टियरडाउन (फ़ंक्शन) में जारी किए जाते हैं। परीक्षण के लिए खुद को, जो निर्धारण में उपयोग किया जाता, मैक्रोज़ TEST_F का उपयोग कर के रूप में घोषित किया जाना चाहिए पहले पैरामीटर जो निर्दिष्ट किया जाना चाहिए परीक्षण के सेट नाम और निर्धारण के नाम नहीं है।

प्रत्येक परीक्षा के लिए, एक नया ताला, बनाया जाएगा कॉन्फ़िगर किया गया सेटअप () का उपयोग कर, परीक्षण, मदद टियरडाउन () और निर्धारण की वस्तु को हटा दिया, मुक्त कर दिया संसाधनों चलाते हैं। इस प्रकार, प्रत्येक परीक्षा में पिछले परीक्षण द्वारा निर्धारण "दूषित नहीं" की अपनी प्रति होगी।

 #include <gtest/gtest.h> #include <iostream> class Foo { public: Foo() : i(0) { std::cout << "CONSTRUCTED" << std::endl; } ~Foo() { std::cout << "DESTRUCTED" << std::endl; } int i; }; class TestFoo : public ::testing::Test { protected: void SetUp() { foo = new Foo; foo->i = 5; } void TearDown() { delete foo; } Foo *foo; }; TEST_F(TestFoo, test1) { ASSERT_EQ(foo->i, 5); foo->i = 10; } TEST_F(TestFoo, test2) { ASSERT_EQ(foo->i, 5); } int main(int argc, char *argv[]) { ::testing::InitGoogleTest(&argc, argv); return RUN_ALL_TESTS(); } argv); #include <gtest/gtest.h> #include <iostream> class Foo { public: Foo() : i(0) { std::cout << "CONSTRUCTED" << std::endl; } ~Foo() { std::cout << "DESTRUCTED" << std::endl; } int i; }; class TestFoo : public ::testing::Test { protected: void SetUp() { foo = new Foo; foo->i = 5; } void TearDown() { delete foo; } Foo *foo; }; TEST_F(TestFoo, test1) { ASSERT_EQ(foo->i, 5); foo->i = 10; } TEST_F(TestFoo, test2) { ASSERT_EQ(foo->i, 5); } int main(int argc, char *argv[]) { ::testing::InitGoogleTest(&argc, argv); return RUN_ALL_TESTS(); } 

कुछ मामलों में, परीक्षण ऑब्जेक्ट बनाना एक बहुत महंगा ऑपरेशन है, और परीक्षण ऑब्जेक्ट्स में कोई बदलाव नहीं करते हैं। इस मामले में, आप प्रत्येक परीक्षा के लिए नए सिरे से तय करने नहीं बनाते हैं, और वैश्विक सेटअप () और टियरडाउन () के साथ वितरित ताला उपयोग कर सकते हैं। फिक्सेशन स्वचालित रूप से वितरित करता है, तो वर्ग कम से कम एक स्थिर सदस्य है। स्टेटिक कार्यों SetUpTestCase () और TearDownTestCase () वस्तु और रिहाई संसाधनों की सेटिंग तदनुसार के लिए बुलाया जाएगा। इस प्रकार, पहले टेस्ट से पहले परीक्षण का एक सेट SetUpTestCase () का कारण होगा, और पिछले TearDownTestCase के बाद ()।

यदि पूरे परीक्षण कार्यक्रम के लिए सेटअप () और टियरडाउन () की आवश्यकता है, और न केवल एक परीक्षण सूट के लिए, तो आपको :: परीक्षण :: पर्यावरण, ओवरराइड सेटअप () और टियरडाउन () और फ़ंक्शन का उपयोग करके इसे पंजीकृत करना होगा। AddGlobalTestEnvironment।

परीक्षण चल रहा है

सभी आवश्यक परीक्षण घोषित करने के बाद, हम उन्हें RUN_ALL_TESTS () फ़ंक्शन का उपयोग करके चला सकते हैं। एक फ़ंक्शन को केवल एक बार बुलाया जा सकता है। यह सलाह दी जाती है, जैसा कि कुछ स्वचालित परीक्षण उपकरण परीक्षण कार्यक्रम के परिणाम को निर्धारित सुनिश्चित करने के लिए है कि यह परीक्षण कार्यक्रम रिटर्न के लिए काम RUN_ALL_TESTS का परिणाम () फ़ंक्शन देता है।

झंडे

RUN_ALL_TESTS से पहले कहा जाता है () फ़ंक्शन InitGoogleTest (argc, argv) बनाता है अपने परीक्षण कार्यक्रम सिर्फ एक निष्पादन योग्य फ़ाइल है कि प्रदर्शित करता है परीक्षण के परिणाम नहीं है। यह एक समग्र अनुप्रयोग है कि इनपुट पैरामीटर है कि अपने व्यवहार को बदलने के लेता है। हमेशा की तरह, -h, --help विकल्प आपको सभी समर्थित विकल्पों की एक सूची देगा। मैं उनमें से कुछ की गणना करेगा (एक पूरी सूची के दस्तावेज़ देखें)।

• ./test --gtest_filter = TestCaseName * -। TestCaseName.SomeTest - चलाने के सभी परीक्षणों TestCaseName SomeTest को छोड़कर सेट
• ./test --gtest_repeat = 1000 --gtest_break_on_failure - पहली असफलता से कम 1000 की और बंद करने के लिए परीक्षण कार्यक्रम चलाने
• ./test --gtest_output = «xml: out.xml» - std :: बाहर out.xml के जारी करने के अलावा बनाया जाएगा - परीक्षण कार्यक्रम को क्रियान्वित करने के परिणामों के साथ एक्सएमएल रिपोर्ट
• ./test --gtest_shuffle - यादृच्छिक क्रम में परीक्षण चलाने

यदि आप लगातार किसी भी पैरामीटर का उपयोग करते हैं, तो आप उपयुक्त पर्यावरण चर सेट कर सकते हैं और मापदंडों के बिना निष्पादन योग्य फ़ाइल चला सकते हैं। उदाहरण के लिए, वैरिएबल GTEST_ALSO_RUN_DISABLED_TESTS को एक गैर-शून्य मान पर सेट करना --gtest_also_run_disabled_tests ध्वज का उपयोग करने के बराबर है।

एक निष्कर्ष के बजाय

इस पोस्ट में, मैं संक्षेप में Google टेस्ट फ्रेमवर्क के मुख्य कार्यों पर चला गया। अधिक विस्तृत जानकारी के लिए देखना चाहिए प्रलेखन । वहाँ से, आप जानकारी प्राप्त कर सकते के बारे में ASSERT_DEATH गिरावट कार्यक्रम में इस्तेमाल किया, parameterized परीक्षणों के अतिरिक्त पत्रिकाओं के संचालन पर, वर्ग के उत्पादन में परीक्षण निजी सदस्यों को विन्यस्त, और अधिक।

युपीडी: सही ढंग से ध्यान दिया habrapolzovatelya Nikel झंडे के उपयोग पर संक्षिप्त inofrmatsiya गयी।
UPD 2: हैबे (मूल टैग स्रोत) पर परिवर्तन के बाद एक अंकन का सुधार।