हम जानते हैं कि docstring Python में फ़ंक्शन और क्लास के बारे में अतिरिक्त जानकारी देता है। हम doctest मॉड्यूल का उपयोग करके फ़ंक्शन के परीक्षण के लिए भी इसका उपयोग कर सकते हैं। doctest मॉड्यूल >>> से शुरू होने वाले कोड को निष्पादित करता है और इसकी तुलना अपेक्षित आउटपुट से करता है।
doctest के साथ फ़ंक्शन लिखने के लिए नीचे दिए गए चरणों का पालन करें।
doctest मॉड्यूल आयात करें।
docstring के साथ फ़ंक्शन लिखें। docstring के अंदर, उसी फ़ंक्शन के परीक्षण के लिए निम्न दो पंक्तियाँ लिखें।
>>>function_name(*args).
अपेक्षित आउटपुट।
फ़ंक्शन कोड लिखें।
अब परीक्षण के लिए doctest.testmod(name=function_name, verbose=True) फ़ंक्शन कॉल करें। यदि verbose False पर सेट है और सभी परीक्षण पास हो गए हैं तो हम टेस्ट परिणाम नहीं देख सकते। इसे True के रूप में सेट करना बेहतर है।
उदाहरण
आइए doctest के साथ एक सरल फ़ंक्शन लिखें।
# मॉड्यूल आयात करना
import doctest
# फ़ंक्शन
def numbers_sum(*args) -> int:
"""
यह फ़ंक्शन सभी आर्गुमेंट का योग लौटाता है
परीक्षण के लिए शेल कमांड
फ़ंक्शन को इनवोक करना उसके बाद अपेक्षित आउटपुट:
>>> numbers_sum(1, 2, 3, 4, 5)
15
>>> numbers_sum(6, 7, 8)
21
"""
return sum(args)
# testmod फ़ंक्शन इनवोक करना
doctest.testmod(name='numbers_sum', verbose=True)
यदि आप उपरोक्त कोड चलाते हैं, तो आपको निम्न परिणाम मिलेंगे।
Trying: numbers_sum(1, 2, 3, 4, 5) Expecting: 15 ok Trying: numbers_sum(6, 7, 8) Expecting: 21 ok 1 items had no tests: numbers_sum 1 items passed all tests: 2 tests in numbers_sum.numbers_sum 2 tests in 2 items. 2 passed and 0 failed. Test passed. TestResults(failed=0, attempted=2)
यदि आप आउटपुट देखते हैं, तो प्रत्येक परीक्षण के बाद ok शब्द है। इसका मतलब है कि अपेक्षित आउटपुट और वास्तविक आउटपुट मेल खाते हैं। आप आउटपुट के अंत में टेस्ट परिणाम देख सकते हैं।
उदाहरण
आइए देखें कि जब परीक्षण विफल होते हैं तो क्या होता है। गलत आउटपुट के साथ वही उदाहरण चलाएं।
# मॉड्यूल आयात करना
import doctest
# फ़ंक्शन
def numbers_sum(*args) -> int:
"""
यह फ़ंक्शन सभी आर्गुमेंट का योग लौटाता है
परीक्षण के लिए शेल कमांड
फ़ंक्शन को इनवोक करना उसके बाद अपेक्षित आउटपुट:
>>> numbers_sum(1, 2, 3, 4, 5)
10
>>> numbers_sum(6, 7, 8)
23
"""
return sum(args)
# testmod फ़ंक्शन इनवोक करना
doctest.testmod(name='numbers_sum', verbose=True)
आउटपुट
यदि आप उपरोक्त प्रोग्राम निष्पादित करते हैं, तो आपको निम्न परिणाम मिलेंगे।
Trying: numbers_sum(1, 2, 3, 4, 5) Expecting: 10 ********************************************************************** File "__main__", line 10, in numbers_sum.numbers_sum Failed example: numbers_sum(1, 2, 3, 4, 5) Expected: 10 Got: 15 Trying: numbers_sum(6, 7, 8) Expecting: 23 ********************************************************************** File "__main__", line 12, in numbers_sum.numbers_sum Failed example: numbers_sum(6, 7, 8) Expected: 23 Got: 21 1 items had no tests: numbers_sum ********************************************************************** 1 items had failures: 2 of 2 in numbers_sum.numbers_sum 2 tests in 2 items. 0 passed and 2 failed. ***Test Failed*** 2 failures. TestResults(failed=2, attempted=2)
यदि आप टेस्ट परिणाम देखते हैं, तो 2 विफल हैं। आप आउटपुट में अपेक्षित और वास्तविक आउटपुट भी देख सकते हैं।
निष्कर्ष
यदि ट्यूटोरियल में आपके कोई संदेह हैं, तो उन्हें टिप्पणी अनुभाग में उल्लेख करें।