🚣🏼 🕶️ 🤙🏾 पायथन के साथ पायथन परीक्षण। अध्याय 3 पाइस्टेस्ट फिक्स्चर 🤲🏼 👨🏻‍✈️ 🥑

यह पुस्तक गायब अध्याय है जो हर व्यापक पायथन पुस्तक से गायब है।

फ्रैंक बर्बाद
प्रिंसिपल साइट विश्वसनीयता इंजीनियर, बॉक्स, इंक।

इस पुस्तक में उदाहरण Python 3.6 और pytest 3.2 का उपयोग करके लिखे गए हैं। पाइस्टेस्ट 3.2 पायथन 2.6, 2.7 और पायथन 3.3+ का समर्थन करता है

टास्क परियोजना के लिए स्रोत कोड, साथ ही साथ इस पुस्तक में दिखाए गए सभी परीक्षणों के लिए, पुस्तक के वेब पेज pragprog.com पर लिंक पर उपलब्ध है। परीक्षण कोड को समझने के लिए आपको स्रोत कोड डाउनलोड करने की आवश्यकता नहीं है; परीक्षण कोड उदाहरणों में एक सुविधाजनक रूप में प्रस्तुत किया गया है। लेकिन परियोजना के कार्यों के साथ पालन करने के लिए, या अपनी खुद की परियोजना का परीक्षण करने के लिए परीक्षण उदाहरणों को अनुकूलित करें (आपके हाथ अनटूट हो गए हैं!), आपको पुस्तक के वेब पेज पर जाना होगा और काम डाउनलोड करना होगा। वहाँ, पुस्तक के वेब पेज पर, इरेटा संदेशों और एक चर्चा मंच के लिए एक लिंक है।

स्पॉइलर के तहत इस श्रृंखला के लेखों की एक सूची है।

सामग्री की तालिका

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

यहाँ एक सरल स्थिरता उदाहरण है जो एक नंबर लौटाता है:

ch3 / test_fixtures.py

 import pytest @pytest.fixture() def some_data(): """Return answer to ultimate question.""" return 42 def test_some_data(some_data): """Use fixture return value in a test.""" assert some_data == 42

@pytest.fixture() डेकोरेटर का उपयोग pytest को बताने के लिए किया जाता है कि फ़ंक्शन एक फिक्सेटर है। जब आप परीक्षण फ़ंक्शन के पैरामीटर सूची में स्थिरता नाम शामिल करते हैं, तो पाइस्टेस्ट जानता है कि परीक्षण चलाने से पहले इसे कैसे चलाना है। फिक्स्चर काम कर सकते हैं, या वे एक परीक्षण समारोह में डेटा वापस कर सकते हैं।

test_some_data() परीक्षण में पैरामीटर के रूप में some_data नाम some_data । पाइस्टेस्ट इसका पता लगाएगा और उस नाम के साथ एक जुड़ाव खोजेगा। पाइस्ट में नाम महत्वपूर्ण है। Pytest परीक्षण मॉड्यूल में उस नाम के साथ एक स्थिरता की तलाश करेगा। अगर वह इसमें नहीं मिलता है तो वह भी conftest.py में खोज करेगा।

इससे पहले कि हम जुड़नार (और conftest.py फ़ाइल) पर अपना शोध शुरू करें, मुझे इस तथ्य पर विचार करने की आवश्यकता है कि शब्द निर्धारण में प्रोग्रामिंग और परीक्षण समुदाय और यहां तक कि पायथन समुदाय में कई अर्थ हैं। मैं इस अध्याय में वर्णित @pytest.fixture() फ़ंक्शन को संदर्भित करने के लिए fixture , fixture function , और fixture method उपयोग करता हूं। स्थिरता का उपयोग एक संसाधन को इंगित करने के लिए भी किया जा सकता है जिसे एक स्थिरता फ़ंक्शन द्वारा संदर्भित किया जाता है। फिक्स्चर फ़ंक्शंस अक्सर कुछ डेटा सेट या पुनर्प्राप्त करते हैं जो परीक्षण के साथ काम कर सकते हैं। कभी-कभी यह डेटा स्थिरता माना जाता है। उदाहरण के लिए, Django समुदाय अक्सर कुछ कच्चे डेटा को इंगित करने के लिए जुड़नार का उपयोग करता है जो अनुप्रयोग की शुरुआत में डेटाबेस में लोड होता है।

अन्य अर्थों के बावजूद, pytest में और इस पुस्तक में, परीक्षण फिक्स्चर उस तंत्र को संदर्भित करते हैं जो pytest आपके परीक्षण कार्यों से "कोड के लिए तैयार" और "सफाई के बाद" कोड को अलग करने के लिए प्रदान करता है।

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

Conftest.py के माध्यम से जुड़नार साझा करना

आप जुड़नार को अलग-अलग परीक्षण फ़ाइलों में रख सकते हैं, लेकिन कई परीक्षण फ़ाइलों में जुड़नार साझा करने के लिए, सभी परीक्षणों के लिए केंद्रीय स्थान पर, कहीं सामान्य रूप से कॉन्टेस्टस्टेम फ़ाइल का उपयोग करना बेहतर होता है। किसी कार्य प्रोजेक्ट के लिए, सभी फिक्स्चर tasks_proj/tests/conftest.py ।

वहां से, जुड़नार किसी भी आटे से साझा किए जा सकते हैं। यदि आप चाहते हैं कि जुड़नार का उपयोग केवल इस फ़ाइल के परीक्षणों में किया जाए, तो आप अलग-अलग परीक्षण फ़ाइलों में जुड़नार लगा सकते हैं। इसी तरह, आपके पास शीर्ष परीक्षण निर्देशिका की उपनिर्देशिकाओं में अन्य conftest.py फाइलें हो सकती हैं। यदि आप करते हैं, तो निम्न-स्तरीय conftest.py फ़ाइलों में परिभाषित जुड़नार इस निर्देशिका और उपनिर्देशिकाओं में परीक्षण के लिए उपलब्ध होंगे। हालांकि, अब तक टास्क प्रोजेक्ट में फिक्स्चर किसी भी परीक्षण के लिए डिज़ाइन किए गए हैं। इसलिए, परीक्षण के मूल में conftest.py फ़ाइल में हमारे सभी उपकरणों का उपयोग करना, tasks_proj/tests , सबसे अधिक समझ में आता है।

हालाँकि conftest.py एक पायथन मॉड्यूल है, इसे परीक्षण फ़ाइलों द्वारा आयात नहीं किया जाना चाहिए। कब आयात आयात मत करो! Conftest.py फ़ाइल को पाइस्टेस्ट द्वारा पढ़ा जाता है और इसे एक स्थानीय प्लग-इन माना जाता है, जो स्पष्ट हो जाएगा जब हम अध्याय 5 में प्लग-इन के बारे में बात करना शुरू करते हैं। पृष्ठ 95 पर "प्लग-इन"। अभी के लिए, tests/conftest.py को उस जगह के रूप में tests/conftest.py जहां हम जुड़नार का उपयोग करने के लिए डाल सकते हैं। परीक्षण निर्देशिका में सभी परीक्षण। तो चलो जुड़नार का सही उपयोग करने के लिए task_proj लिए हमारे कुछ परीक्षणों को task_proj से काम करते हैं।

सेटअप और टियरडाउन के लिए फिक्स्चर का उपयोग करना

कार्य परियोजना में अधिकांश परीक्षण मानते हैं कि कार्य डेटाबेस पहले से ही कॉन्फ़िगर, चल रहा है, और तैयार है। और हमें अंत में कुछ प्रविष्टियों को हटाना होगा, अगर सफाई की कोई आवश्यकता है। और आपको डेटाबेस से डिस्कनेक्ट करने की आवश्यकता भी हो सकती है। सौभाग्य से, इसमें से अधिकांश को टास्क कोड में tasks.start_tasks_db(<directory to store db\>, 'tiny' or 'mongo') tasks.stop_tasks_db() tasks.start_tasks_db(<directory to store db\>, 'tiny' or 'mongo') tasks.stop_tasks_db() tasks.start_tasks_db(<directory to store db\>, 'tiny' or 'mongo') और tasks.stop_tasks_db() ; हमें बस उन्हें सही समय पर कॉल करने की आवश्यकता है, और हमें एक अस्थायी निर्देशिका की भी आवश्यकता है।

सौभाग्य से, pytest में एक उत्कृष्ट स्थिरता शामिल है जिसे tmpdir कहा जाता है। हम इसे परीक्षण के लिए उपयोग कर सकते हैं और सफाई के बारे में चिंता करने की ज़रूरत नहीं है। यह जादू नहीं है, सबसे जिज्ञासु लोगों से सिर्फ अच्छा कोडिंग अभ्यास है। (चिंता न करें; हम tmpdir का विश्लेषण करेंगे और पृष्ठ "71 पर tmpdir और tmpdir_factory का उपयोग करके" अनुभाग में tmpdir_factory का उपयोग करके इसे और अधिक विस्तार से लिखेंगे।)

इन सभी घटकों को देखते हुए, यह स्थिरता महान काम करती है:

ch3 / a / tasks_proj /tests/conftest.py

 import pytest import tasks from tasks import Task @pytest.fixture() def tasks_db(tmpdir): """    ,  .""" # Setup : start db tasks.start_tasks_db(str(tmpdir), 'tiny') yield #    # Teardown : stop db tasks.stop_tasks_db()

Tmpdir का मान स्ट्रिंग नहीं है - यह एक ऐसी वस्तु है जो एक निर्देशिका का प्रतिनिधित्व करती है। हालाँकि, यह start_tasks_db() को लागू करता है, इसलिए हम स्ट्रिंग का उपयोग कर सकते हैं str() स्ट्रिंग को पाने के लिए start_tasks_db() । अभी के लिए, हम अभी भी TinyDB के लिए छोटे का उपयोग कर रहे हैं।

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

आइए इस tasks.add() का उपयोग करने के लिए अपने किसी कार्य को संशोधित करें।

ch3 / a / tasks_proj / परीक्षण / func / test_add .py

 import pytest import tasks from tasks import Task def test_add_returns_valid_id(tasks_db): """tasks.add(<valid task>)    .""" # GIVEN    # WHEN    # THEN  task_id  int new_task = Task('do something') task_id = tasks.add(new_task) assert isinstance(task_id, int)

यहां मुख्य परिवर्तन यह है कि फ़ाइल में अतिरिक्त स्थिरता को हटा दिया गया है, और हमने परीक्षण मापदंडों की सूची में tasks_db जोड़ा है। मुझे टिप्पणियों का उपयोग करके GIVEN / WHEN / THEN प्रारूप (DANO / WHEN / AFTER) में संरचना परीक्षण करना पसंद है, खासकर अगर यह कोड से स्पष्ट नहीं है कि क्या हो रहा है। मुझे लगता है कि यह इस मामले में उपयोगी है। उम्मीद है कि GIVEN आरंभीकृत db कार्य यह पता लगाने में मदद करेगा कि tasks_db उपयोग परीक्षण के लिए एक उपकरण के रूप में क्यों किया जाता है

सुनिश्चित करें कि कार्य स्थापित है।

हम अभी भी इस अध्याय में कार्य परियोजना के लिए परीक्षण लिख रहे हैं, जो पहले अध्याय 2 में स्थापित किया गया था। यदि आपने इस अध्याय को छोड़ दिया है, तो सीडी कोड के साथ कार्यों को स्थापित करना सुनिश्चित करें; pip install ./tasks_proj/ । / pip install ./tasks_proj/ ।

-सेटअप-शो के साथ ट्रेसिंग फिक्सेशन निष्पादन

यदि आप अंतिम खंड से परीक्षण चलाते हैं, तो आप यह नहीं देख पाएंगे कि कौन से जुड़नार चल रहे हैं:

 $ cd /path/to/code/ $ pip install ./tasks_proj/ #      $ cd /path/to/code/ch3/a/tasks_proj/tests/func $ pytest -v test_add.py -k valid_id ===================== test session starts ====================== collected 3 items test_add.py::test_add_returns_valid_id PASSED ====================== 2 tests deselected ====================== ============ 1 passed, 2 deselected in 0.02 seconds ============

जब मैं फिक्स्चर डिजाइन करता हूं, तो मुझे यह देखने की आवश्यकता है कि क्या काम करता है और कब। सौभाग्य से, पाइस्टेस्ट इस तरह की कमांड लाइन फ्लैग, -- setup-show प्रदान करता है, जो सिर्फ यही करता है:

 $ pytest --setup-show test_add.py -k valid_id ============================= test session starts ============================= collected 3 items / 2 deselected test_add.py SETUP S tmpdir_factory SETUP F tmpdir (fixtures used: tmpdir_factory) SETUP F tasks_db (fixtures used: tmpdir) func/test_add.py::test_add_returns_valid_id (fixtures used: tasks_db, tmpdir, tmpdir_factory). TEARDOWN F tasks_db TEARDOWN F tmpdir TEARDOWN S tmpdir_factory =================== 1 passed, 2 deselected in 0.18 seconds ====================

हमारा परीक्षण मध्य में है, और प्रत्येक स्थिरता के लिए सेटप और टीएआरडीएचई भाग को पहले से ही निर्धारित किया गया है। test_add_returns_valid_id शुरू करते test_add_returns_valid_id , आप देखते हैं कि परीक्षण से पहले tmpdir ने काम किया। और tmpdir_factory पहले tmpdir_factory । tmpdir इसे एक स्थिरता के रूप में उपयोग कर रहा है।

स्थिरता के नामों के सामने एफ और एस क्षेत्र को इंगित करते हैं। स्कोप के लिए एफ और सत्र स्कोप के लिए एस । मैं पृष्ठ ५६ पर "स्कोप स्थिरता विनिर्देश" खंड में गुंजाइश को कवर करूंगा।

टेस्ट डेटा के लिए फिक्स्चर का उपयोग करना

फिक्स्चर परीक्षण के लिए डेटा स्टोर करने के लिए एक शानदार जगह है। आप कुछ भी वापस कर सकते हैं। यहाँ एक फ़िक्सचर है जो मिश्रित प्रकार का टपल लौटाता है:

ch3 / test_fixtures.py

 @pytest.fixture() def a_tuple(): """ -  """ return (1, 'foo', None, {'bar': 23}) def test_a_tuple(a_tuple): """Demo the a_tuple fixture.""" assert a_tuple[3]['bar'] == 32

चूंकि test_a_tuple() विफल होना चाहिए (23! = 32) , हम देखेंगे कि क्या होता है जब स्थिरता परीक्षण विफल हो जाता है:

 $ cd /path/to/code/ch3 $ pytest test_fixtures.py::test_a_tuple ============================= test session starts ============================= collected 1 item test_fixtures.py F [100%] ================================== FAILURES =================================== ________________________________ test_a_tuple _________________________________ a_tuple = (1, 'foo', None, {'bar': 23}) def test_a_tuple(a_tuple): """Demo the a_tuple fixture.""" > assert a_tuple[3]['bar'] == 32 E assert 23 == 32 test_fixtures.py:38: AssertionError ========================== 1 failed in 0.17 seconds ===========================

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

 $ pytest -v test_fixtures.py::test_other_data ============================= test session starts ============================= test_fixtures.py::test_other_data ERROR [100%] =================================== ERRORS ==================================== ______________________ ERROR at setup of test_other_data ______________________ @pytest.fixture() def some_other_data(): """Raise an exception from fixture.""" x = 43 > assert x == 42 E assert 43 == 42 test_fixtures.py:21: AssertionError =========================== 1 error in 0.13 seconds ===========================

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

लेकिन टास्क प्रोजेक्ट के बारे में क्या? कार्य परियोजना के लिए, हम शायद कुछ डेटा जुड़नार का उपयोग कर सकते हैं, संभवतः विभिन्न गुणों के साथ अलग-अलग कार्य सूचियां:

ch3 / a / task_proj / परीक्षण / conftest.py

 #    Task constructor # Task(summary=None, owner=None, done=False, id=None) # summary    # owner  done   # id    @pytest.fixture() def tasks_just_a_few(): """    .""" return ( Task('Write some code', 'Brian', True), Task("Code review Brian's code", 'Katie', False), Task('Fix what Brian did', 'Michelle', False)) @pytest.fixture() def tasks_mult_per_owner(): """     .""" return ( Task('Make a cookie', 'Raphael'), Task('Use an emoji', 'Raphael'), Task('Move to Berlin', 'Raphael'), Task('Create', 'Michelle'), Task('Inspire', 'Michelle'), Task('Encourage', 'Michelle'), Task('Do a handstand', 'Daniel'), Task('Write some books', 'Daniel'), Task('Eat ice cream', 'Daniel'))

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

एकाधिक फिक्स्चर का उपयोग करना

आप पहले ही देख चुके हैं कि tmpdir tmpdir_factory का उपयोग करता है। और आपने हमारे टास्क_ डीबी स्थिरता में tmpdir का उपयोग किया। चलिए श्रृंखला जारी रखते हैं और कार्य परियोजना के गैर-खाली ठिकानों के लिए कुछ विशेष जुड़नार जोड़ते हैं:

ch3 / a / task_proj / परीक्षण / conftest.py

 @pytest.fixture() def db_with_3_tasks(tasks_db, tasks_just_a_few): """   3 ,  .""" for t in tasks_just_a_few: tasks.add(t) @pytest.fixture() def db_with_multi_per_owner(tasks_db, tasks_mult_per_owner): """   9 , 3 owners,  3   .""" for t in tasks_mult_per_owner: tasks.add(t)

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

ch3 / a / functions_proj / परीक्षण / func / test_add.py

 def test_add_increases_count(db_with_3_tasks): """Test tasks.add()    tasks.count().""" # GIVEN db  3  # WHEN     tasks.add(Task('throw a party')) # THEN    1 assert tasks.count() == 4

यह भी जुड़नार का उपयोग करने के लिए मुख्य कारणों में से एक का प्रदर्शन करता है: परीक्षण पर ध्यान केंद्रित करने के लिए जो आप वास्तव में परीक्षण कर रहे हैं, उस पर ध्यान केंद्रित करने के बजाय आपको परीक्षण की तैयारी के लिए क्या करना था। मुझे GIVEN / WHEN / THEN के लिए टिप्पणियों का उपयोग करना पसंद है और दो कारणों से जुड़नार में जितना संभव हो उतना डेटा (GIVEN) पुश करने की कोशिश कर रहा हूं। सबसे पहले, यह परीक्षण को अधिक पठनीय बनाता है और इसलिए अधिक बनाए रखने योग्य है। दूसरे, एक एस्टर या अपवाद एक त्रुटि (ERROR) में परिणाम देता है, जबकि परीक्षण फ़ंक्शन में एक एस्टर या अपवाद के परिणामस्वरूप त्रुटि (FAIL) होती है। मैं नहीं चाहता कि test_add_increases_count() डेटाबेस के आरंभ में विफल होने पर विफल हो जाए। यह सिर्फ भ्रामक है। मैं चाहता हूं कि test_add_increases_count() की विफलता (FAIL) केवल तभी संभव हो सकती है जब add () वास्तव में काउंटर को बदल न सके। आइए दौड़ें और देखें कि सभी जुड़नार कैसे काम करते हैं:

 $ cd /path/to/code/ch3/a/tasks_proj/tests/func $ pytest --setup-show test_add.py::test_add_increases_count ============================= test session starts ============================= collected 1 item test_add.py SETUP S tmpdir_factory SETUP F tmpdir (fixtures used: tmpdir_factory) SETUP F tasks_db (fixtures used: tmpdir) SETUP F tasks_just_a_few SETUP F db_with_3_tasks (fixtures used: tasks_db, tasks_just_a_few) func/test_add.py::test_add_increases_count (fixtures used: db_with_3_tasks, tasks_db, tasks_just_a_few, tmpdir, tmpdir_factory). TEARDOWN F db_with_3_tasks TEARDOWN F tasks_just_a_few TEARDOWN F tasks_db TEARDOWN F tmpdir TEARDOWN S tmpdir_factory ========================== 1 passed in 0.20 seconds ===========================

हमें फंक्शन और सत्र क्षेत्र के लिए फिर से एफएस और एसएस का एक गुच्छा मिला। आइए देखें कि यह क्या है।

स्कोप स्थिरता विनिर्देश

फिक्स्चर में गुंजाइश नामक एक वैकल्पिक पैरामीटर शामिल होता है, जो निर्धारित करता है कि जुड़नार कितनी बार सेटअप और टॉरडाउन प्राप्त करते हैं। @ pytest.fixture() लिए गुंजाइश पैरामीटर में फ़ंक्शन, वर्ग, मॉड्यूल या सत्र मान हो सकते हैं। स्कोप डिफ़ॉल्ट रूप से एक फ़ंक्शन है। कार्य_db सेटिंग्स और सभी जुड़नार अभी तक एक क्षेत्र को परिभाषित नहीं करते हैं। इस प्रकार, वे कार्यात्मक जुड़नार हैं।

प्रत्येक स्कोप मान का संक्षिप्त विवरण निम्नलिखित है:

कार्यक्षेत्र = 'कार्य'

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

प्रत्येक परीक्षण वर्ग के लिए इसे एक बार निष्पादित किया जाता है, कक्षा में परीक्षण विधियों की संख्या की परवाह किए बिना।
गुंजाइश = 'मॉड्यूल'

मॉड्यूल का उपयोग करते समय कितने परीक्षण कार्यों या विधियों या अन्य जुड़नार का उपयोग किया जाता है, इसकी परवाह किए बिना इसे प्रत्येक मॉड्यूल के लिए एक बार निष्पादित किया जाता है।
गुंजाइश = 'सत्र'

यह प्रति सत्र एक बार किया जाता है। सभी परीक्षण विधियों और फ़ंक्शन जो सत्र गुंजाइश जुड़नार का उपयोग करते हैं, एक एकल सेटअप और फाड़ कॉल का उपयोग करते हैं।

कार्रवाई में गुंजाइश मान इस तरह दिखते हैं:

ch3 / test_scope.py

 """Demo fixture scope.""" import pytest @pytest.fixture(scope='function') def func_scope(): """A function scope fixture.""" @pytest.fixture(scope='module') def mod_scope(): """A module scope fixture.""" @pytest.fixture(scope='session') def sess_scope(): """A session scope fixture.""" @pytest.fixture(scope='class') def class_scope(): """A class scope fixture.""" def test_1(sess_scope, mod_scope, func_scope): """   ,   .""" def test_2(sess_scope, mod_scope, func_scope): """     .""" @pytest.mark.usefixtures('class_scope') class TestSomething(): """Demo class scope fixtures.""" def test_3(self): """Test using a class scope fixture.""" def test_4(self): """Again, multiple tests are more fun."""

चलो यह --setup-show के लिए --setup-show का उपयोग करते हैं कि --setup-show के साथ जोड़ी गई स्थिरता और सेटअप कॉल की संख्या क्षेत्र के आधार पर की जाती है:

 $ cd /path/to/code/ch3/ $ pytest --setup-show test_scope.py ============================= test session starts ============================= collected 4 items test_scope.py SETUP S sess_scope SETUP M mod_scope SETUP F func_scope test_scope.py::test_1 (fixtures used: func_scope, mod_scope, sess_scope). TEARDOWN F func_scope SETUP F func_scope test_scope.py::test_2 (fixtures used: func_scope, mod_scope, sess_scope). TEARDOWN F func_scope SETUP C class_scope test_scope.py::TestSomething::()::test_3 (fixtures used: class_scope). test_scope.py::TestSomething::()::test_4 (fixtures used: class_scope). TEARDOWN C class_scope TEARDOWN M mod_scope TEARDOWN S sess_scope ========================== 4 passed in 0.11 seconds ===========================

अब आप फ़ंक्शन और सत्र के लिए न केवल एफ और एस देख सकते हैं, बल्कि वर्ग और मॉड्यूल के लिए सी और एम भी देख सकते हैं।

गुंजाइश जुड़नार का उपयोग कर परिभाषित किया गया है। मुझे पता है कि यह कोड से स्पष्ट है, लेकिन यह सुनिश्चित करने के लिए एक महत्वपूर्ण बिंदु है कि आप पूरी तरह से कराह रहे हैं। समझ ”)। दायरा निर्धारण परिभाषा में परिभाषित किया गया है, और इसके कॉल के स्थान पर नहीं। जुड़नार का उपयोग करने वाले परीक्षण कार्य कितनी बार (SETUP) और स्थिरता टूटने (TEARDOWN) को नियंत्रित नहीं करते हैं।

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

टास्क प्रोजेक्ट फिक्स्चर के लिए स्कोप बदलें

गुंजाइश के इस ज्ञान को देखते हुए, चलो अब टास्क परियोजना के कुछ जुड़नार के दायरे को बदलते हैं।

अब तक, हमें परीक्षण समय के साथ कोई समस्या नहीं हुई है। लेकिन, आपको यह स्वीकार करना चाहिए कि प्रत्येक परीक्षण के लिए एक अस्थायी निर्देशिका और एक नया डेटाबेस कनेक्शन बनाना बेकार है। जब तक हम एक खाली डेटाबेस प्रदान कर सकते हैं, जब तक आवश्यक हो, यह पर्याप्त होना चाहिए।

सत्र के कार्यक्षेत्र के रूप में tasks_db जैसी किसी चीज़ का उपयोग करने के लिए, आपको tmpdir_factory उपयोग करना होगा, क्योंकि tmpdir फ़ंक्शन का कार्यक्षेत्र है और tmpdir_factory सत्र का कार्यक्षेत्र है। सौभाग्य से, यह कोड परिवर्तन की सिर्फ एक पंक्ति है (ठीक है, दो यदि आप पैरामीटर सूची में tmpdir->tmpdir_factory पर विचार tmpdir->tmpdir_factory ):

ch3 / b / task_proj / परीक्षण / conftest.py

 """Define some fixtures to use in the project.""" import pytest import tasks from tasks import Task @pytest.fixture(scope='session') def tasks_db_session(tmpdir_factory): """Connect to db before tests, disconnect after.""" temp_dir = tmpdir_factory.mktemp('temp') tasks.start_tasks_db(str(temp_dir), 'tiny') yield tasks.stop_tasks_db() @pytest.fixture() def tasks_db(tasks_db_session): """An empty tasks db.""" tasks.delete_all()

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

डेटा जुड़नार बस एक मूल्य वापस करते हैं, इसलिए वास्तव में उनके लिए हर समय काम करने का कोई कारण नहीं है। एक बार प्रति सत्र पर्याप्त है:

ch3 / b / task_proj / परीक्षण / conftest.py

 # Reminder of Task constructor interface # Task(summary=None, owner=None, done=False, id=None) # summary is required # owner and done are optional # id is set by database @pytest.fixture(scope='session') def tasks_just_a_few(): """All summaries and owners are unique.""" return ( Task('Write some code', 'Brian', True), Task("Code review Brian's code", 'Katie', False), Task('Fix what Brian did', 'Michelle', False)) @pytest.fixture(scope='session') def tasks_mult_per_owner(): """Several owners with several tasks each.""" return ( Task('Make a cookie', 'Raphael'), Task('Use an emoji', 'Raphael'), Task('Move to Berlin', 'Raphael'), Task('Create', 'Michelle'), Task('Inspire', 'Michelle'), Task('Encourage', 'Michelle'), Task('Do a handstand', 'Daniel'), Task('Write some books', 'Daniel'), Task('Eat ice cream', 'Daniel'))

अब देखते हैं कि क्या ये सभी परिवर्तन हमारे परीक्षणों के साथ काम करेंगे:

 $ cd /path/to/code/ch3/b/tasks_proj $ pytest ===================== test session starts ====================== collected 55 items tests/func/test_add.py ... tests/func/test_add_variety.py ............................ tests/func/test_add_variety2.py ............ tests/func/test_api_exceptions.py ....... tests/func/test_unique_id.py . tests/unit/test_task.py .... ================== 55 passed in 0.17 seconds ===================

सब कुछ क्रम में लगता है। आइए एक एकल परीक्षण फ़ाइल के लिए जुड़नार देखें कि हमारी उम्मीदों के अनुसार विभिन्न क्षेत्र कैसे काम करते हैं:

 $ pytest --setup-show tests/func/test_add.py ============================= test session starts ============================= platform win32 -- Python 3.6.5, pytest-3.9.3, py-1.7.0, pluggy-0.8.0 rootdir: c:\_BOOKS_\pytest_si\bopytest-code\code\ch3\b\tasks_proj\tests, inifile: pytest.ini collected 3 items tests\func\test_add.py SETUP S tmpdir_factory SETUP S tasks_db_session (fixtures used: tmpdir_factory) SETUP F tasks_db (fixtures used: tasks_db_session) func/test_add.py::test_add_returns_valid_id (fixtures used: tasks_db, tasks_db_session, tmpdir_factory). TEARDOWN F tasks_db SETUP F tasks_db (fixtures used: tasks_db_session) func/test_add.py::test_added_task_has_id_set (fixtures used: tasks_db, tasks_db_session, tmpdir_factory). TEARDOWN F tasks_db SETUP S tasks_just_a_few SETUP F tasks_db (fixtures used: tasks_db_session) SETUP F db_with_3_tasks (fixtures used: tasks_db, tasks_just_a_few) func/test_add.py::test_add_increases_count (fixtures used: db_with_3_tasks, tasks_db, tasks_db_session, tasks_just_a_few, tmpdir_factory). TEARDOWN F db_with_3_tasks TEARDOWN F tasks_db TEARDOWN S tasks_db_session TEARDOWN S tmpdir_factory TEARDOWN S tasks_just_a_few ========================== 3 passed in 0.24 seconds ===========================

हाँ। . tasks_db_session , task_db .

Specifying Fixtures with usefixtures

, , , . , @pytest.mark.usefixtures('fixture1', 'fixture2') . usefixtures , , . — . :

ch3/test_scope.py

 @pytest.mark.usefixtures('class_scope') class TestSomething(): """Demo class scope fixtures.""" def test_3(self): """Test using a class scope fixture.""" def test_4(self): """Again, multiple tests are more fun."""

usefixtures , . , , . , - usefixtures , .

autouse Fixtures That Always Get Used ( )

, , ( usefixtures ). autouse=True , . , , . :

ch3/test_autouse.py

 """ autouse fixtures.""" import pytest import time @pytest.fixture(autouse=True, scope='session') def footer_session_scope(): """    session().""" yield now = time.time() print('--') print('finished : {}'.format(time.strftime('%d %b %X', time.localtime(now)))) print('-----------------') @pytest.fixture(autouse=True) def footer_function_scope(): """     .""" start = time.time() yield stop = time.time() delta = stop - start print('\ntest duration : {:0.3} seconds'.format(delta)) def test_1(): """   .""" time.sleep(1) def test_2(): """    .""" time.sleep(1.23)

, . :

 $ cd /path/to/code/ch3 $ pytest -v -s test_autouse.py ===================== test session starts ====================== collected 2 items test_autouse.py::test_1 PASSED test duration : 1.0 seconds test_autouse.py::test_2 PASSED test duration : 1.24 seconds -- finished : 25 Jul 16:18:27 ----------------- =================== 2 passed in 2.25 seconds ===================

autouse . , . , .

, autouse , , tasks_db . Tasks , , , API . . , .

Fixtures

, , , . , pytest name @pytest.fixture() :

ch3/ test_rename_fixture.py

 """ fixture renaming.""" import pytest @pytest.fixture(name='lue') def ultimate_answer_to_life_the_universe_and_everything(): """  .""" return 42 def test_everything(lue): """   .""" assert lue == 42

lue fixture , fixture_with_a_name_much_longer_than_lue . , --setup-show :

 $ pytest --setup-show test_rename_fixture.py ======================== test session starts ======================== collected 1 items test_rename_fixture.py SETUP F lue test_rename_fixture.py::test_everything (fixtures used: lue). TEARDOWN F lue ===================== 1 passed in 0.01 seconds ======================

, lue , pytest --fixtures . , , , :

 $ pytest --fixtures test_rename_fixture.py ======================== test session starts ======================= ... ------------------ fixtures defined from test_rename_fixture ------------------ lue Return ultimate answer. ================= no tests ran in 0.01 seconds =================

— . , , , , , . , lue . «Tasks»:

 $ cd /path/to/code/ch3/b/tasks_proj $ pytest --fixtures tests/func/test_add.py ======================== test session starts ======================== ... tmpdir_factory Return a TempdirFactory instance for the test session. tmpdir Return a temporary directory path object which is unique to each test function invocation, created as a sub directory of the base temporary directory. The returned object is a `py.path.local`_ path object. ----------------------- fixtures defined from conftest ------------------------ tasks_db An empty tasks db. tasks_just_a_few All summaries and owners are unique. tasks_mult_per_owner Several owners with several tasks each. db_with_3_tasks Connected db with 3 tasks, all unique. db_with_multi_per_owner Connected db with 9 tasks, 3 owners, all with 3 tasks. tasks_db_session Connect to db before tests, disconnect after. =================== no tests ran in 0.01 seconds ====================

! conftest.py . tmpdir tmpdir_factory , .

[Parametrized Testing] , . 42, . . - , , :

ch3/b/tasks_proj/tests/func/test_add_variety2.py

"""Test the tasks.add() API function."""

import pytest
import tasks
from tasks import Task

tasks_to_try = (Task('sleep', done=True),
Task('wake', 'brian'),
Task('breathe', 'BRIAN', True),
Task('exercise', 'BrIaN', False))

task_ids = ['Task({},{},{})'.format(t.summary, t.owner, t.done)
for t in tasks_to_try]

def equivalent(t1, t2):
"""Check two tasks for equivalence."""
return ((t1.summary == t2.summary) and
(t1.owner == t2.owner) and
(t1.done == t2.done))

, , a_task :

ch3/b/tasks_proj/tests/func/ test_add_variety2.py

@pytest.fixture(params=tasks_to_try)
def a_task(request):
""" ."""
return request.param

def test_add_a(tasks_db, a_task):
""" a_task ( ids)."""
task_id = tasks.add(a_task)
t_from_db = tasks.get(task_id)
assert equivalent(t_from_db, a_task)

, fixture, , . . param, , params @pytest.fixture(params=tasks_to_try) .

a_task — request.param , . , , :

 $ cd /path/to/code/ch3/b/tasks_proj/tests/func $ pytest -v test_add_variety2.py::test_add_a ===================== test session starts ====================== collected 4 items test_add_variety2.py::test_add_a[a_task0] PASSED test_add_variety2.py::test_add_a[a_task1] PASSED test_add_variety2.py::test_add_a[a_task2] PASSED test_add_variety2.py::test_add_a[a_task3] PASSED =================== 4 passed in 0.03 seconds ===================

, pytest , () . , :

ch3/b/tasks_proj/tests/func/ test_add_variety2.py

@pytest.fixture(params=tasks_to_try, ids=task_ids)
def b_task(request):
""" ."""
return request.param

def test_add_b(tasks_db, b_task):
""" b_task, ."""
task_id = tasks.add(b_task)
t_from_db = tasks.get(task_id)
assert equivalent(t_from_db, b_task)

 $ pytest -v test_add_variety2.py::test_add_b ===================== test session starts ====================== collected 4 items test_add_variety2.py::test_add_b[Task(sleep,None,True)] PASSED test_add_variety2.py::test_add_b[Task(wake,brian,False)] PASSED test_add_variety2.py::test_add_b[Task(breathe,BRIAN,True)] PASSED test_add_variety2.py::test_add_b[Task(exercise,BrIaN,False)] PASSED =================== 4 passed in 0.04 seconds ===================

ids , , . , :

ch3/b/tasks_proj/tests/func/ test_add_variety2.py

def id_func(fixture_value):
""" ."""
t = fixture_value
return 'Task({},{},{})'.format(t.summary, t.owner, t.done)

@pytest.fixture(params=tasks_to_try, ids=id_func)
def c_task(request):
""" (id_func) ."""
return request.param

def test_add_c(tasks_db, c_task):
""" ."""
task_id = tasks.add(c_task)
t_from_db = tasks.get(task_id)
assert equivalent(t_from_db, c_task)

. Task, id_func() Task , namedtuple Task Task . , , :

 $ pytest -v test_add_variety2.py::test_add_c ===================== test session starts ====================== collected 4 items test_add_variety2.py::test_add_c[Task(sleep,None,True)] PASSED test_add_variety2.py::test_add_c[Task(wake,brian,False)] PASSED test_add_variety2.py::test_add_c[Task(breathe,BRIAN,True)] PASSED test_add_variety2.py::test_add_c[Task(exercise,BrIaN,False)] PASSED =================== 4 passed in 0.04 seconds ===================

. , , . , !

Fixtures Tasks Project

, Tasks. TinyDB . , . , , , , TinyDB , MongoDB .

( ), , start_tasks_db() tasks_db_session :

ch3/b/tasks_proj/tests/conftest.py

""" ."""

import pytest
import tasks
from tasks import Task

@pytest.fixture(scope='session')
def tasks_db_session(tmpdir_factory):
""" , ."""
temp_dir = tmpdir_factory.mktemp('temp')
tasks.start_tasks_db(str(temp_dir), 'tiny')
yield
tasks.stop_tasks_db()

@pytest.fixture()
def tasks_db(tasks_db_session):
""" tasks."""
tasks.delete_all()

db_type start_tasks_db() . , :

tasks_proj/src/tasks/api.py

  def start_tasks_db(db_path, db_type): # type: (str, str) -None """  API  .""" if not isinstance(db_path, string_types): raise TypeError('db_path must be a string') global _tasksdb if db_type == 'tiny': import tasks.tasksdb_tinydb _tasksdb = tasks.tasksdb_tinydb.start_tasks_db(db_path) elif db_type == 'mongo': import tasks.tasksdb_pymongo _tasksdb = tasks.tasksdb_pymongo.start_tasks_db(db_path) else: raise ValueError("db_type   'tiny'  'mongo'")

MongoDB, db_type mongo. :

ch3/c/tasks_proj/tests/conftest.py

  import pytest import tasks from tasks import Task # @pytest.fixture(scope='session', params=['tiny',]) @pytest.fixture(scope='session', params=['tiny', 'mongo']) def tasks_db_session(tmpdir_factory, request): """Connect to db before tests, disconnect after.""" temp_dir = tmpdir_factory.mktemp('temp') tasks.start_tasks_db(str(temp_dir), request.param) yield # this is where the testing happens tasks.stop_tasks_db() @pytest.fixture() def tasks_db(tasks_db_session): """An empty tasks db.""" tasks.delete_all()

params=['tiny',' mongo'] -. request temp_db db_type request.param , "tiny" "mongo".

--verbose -v pytest , pytest . , .

MongoDB स्थापित करना

MongoDB, , MongoDB pymongo . MongoDB, https://www.mongodb.com/download-center . pymongo pip— pip install pymongo . MongoDB ; 7 .

  $ cd /path/to/code/ch3/c/tasks_proj $ pip install pymongo $ pytest -v --tb=no ===================== test session starts ====================== collected 92 items test_add.py::test_add_returns_valid_id[tiny] PASSED test_add.py::test_added_task_has_id_set[tiny] PASSED test_add.py::test_add_increases_count[tiny] PASSED test_add_variety.py::test_add_1[tiny] PASSED test_add_variety.py::test_add_2[tiny-task0] PASSED test_add_variety.py::test_add_2[tiny-task1] PASSED ... test_add.py::test_add_returns_valid_id[mongo] FAILED test_add.py::test_added_task_has_id_set[mongo] FAILED test_add.py::test_add_increases_count[mongo] PASSED test_add_variety.py::test_add_1[mongo] FAILED test_add_variety.py::test_add_2[mongo-task0] FAILED ... ============= 42 failed, 50 passed in 4.94 seconds =============

हम्म। . , , - Mongo. , pdb: , . 125. TinyDB.

अभ्यास

test_fixtures.py .
2. fixtures—functions @pytest.fixture() , . , , .
, .
, .
pytest --setup-show test_fixtures.py . ?
scope= 'module' 4.
pytest --setup-show test_fixtures.py . क्या बदल गया है?
6 return <data> yield <data> .
yield .
pytest -s -v test_fixtures.py . ?

आगे क्या है

pytest fixture , , building blocks , setup teardown , (, Mongo TinyDB). , , .

pytest, , (builtin) tmpdir tmpdir_factory. (builtin) .

पीछे अगला

पायथन के साथ पायथन परीक्षण। अध्याय 3 पाइस्टेस्ट फिक्स्चर