Pygame 1.9 - tests

pygame.tests




pygame

pygame.tests

Pygame यूनिट टेस्ट सूट पैकेज

कमांड लाइन से टेस्ट सूट पैकेज को चलाने का एक त्वरित तरीका पायथन-एम विकल्प के साथ गो सबमॉड्यूल को आयात करना है:

python -m pygame.tests [<test options>]

कमांड लाइन विकल्प --help एक उपयोग संदेश प्रदर्शित करता है। उपलब्ध विकल्प pygame.tests.run() तर्कों के अनुरूप हैं।

परीक्षण पैकेज के xxxx_test सबमॉडल्स pygame के अलग-अलग हिस्सों के लिए यूनिट टेस्ट सूट हैं। प्रत्येक को एक मुख्य कार्यक्रम के रूप में भी चलाया जा सकता है। यह उपयोगी है अगर परीक्षण, जैसे कि cdrom_test, इंटरैक्टिव है।

Pygame विकास के लिए टेस्ट सूट को pygame वितरण रूट डायरेक्टरी से चलाया जा सकता है। प्रोग्राम run_tests.py सुविधा के लिए प्रदान किया गया है, हालांकि परीक्षण / go.py सीधे चलाया जा सकता है।

मॉड्यूल स्तर टैग नियंत्रित करते हैं कि कौन से मॉड्यूल एक यूनिट टेस्ट रन में शामिल हैं। टैग को एक इकाई परीक्षण मॉड्यूल के लिए इसी <name> _tags.py मॉड्यूल के साथ सौंपा गया है। टैग मॉड्यूल में वैश्विक __tags__, टैग नामों की एक सूची है। उदाहरण के लिए, cdrom_test.py में एक टैग फ़ाइल cdrom_tags.py जिसमें एक टैग सूची है जिसमें 'इंटरैक्टिव' स्ट्रिंग है। 'इंटरएक्टिव' टैग cdrom_test.py उपयोगकर्ता इनपुट की अपेक्षा करता है। यह एक run_tests.py या pygame.tests.go रन से बाहर रखा गया है। बाहर किए गए दो अन्य टैग 'अनदेखा' और 'सबप्रोसेस_गिनोरे' हैं। ये दो टैग इकाई परीक्षणों को इंगित करते हैं जो किसी विशेष प्लेटफॉर्म पर नहीं चलेंगे, या जिनके लिए कोई संबंधित pygame मॉड्यूल उपलब्ध नहीं है। परीक्षण धावक टैग के साथ प्रत्येक बहिष्कृत मॉड्यूल को सूचीबद्ध करेगा।

pygame.tests.run(*args, **kwds) -> tuple

Pygame यूनिट टेस्ट सूट चलाएं

स्थिति संबंधी तर्क (वैकल्पिक):

The names of tests to include. If omitted then all tests are run. Test names
need not include the trailing '_test'.

कीवर्ड तर्क:

incomplete - fail incomplete tests (default False)
nosubprocess - run all test suites in the current process
               (default False, use separate subprocesses)
dump - dump failures/errors as dict ready to eval (default False)
file - if provided, the name of a file into which to dump failures/errors
timings - if provided, the number of times to run each individual test to
          get an average run time (default is run each test once)
exclude - A list of TAG names to exclude from the run
show_output - show silenced stderr/stdout on errors (default False)
all - dump all results, not just errors (default False)
randomize - randomize order of tests (default False)
seed - if provided, a seed randomizer integer
multi_thread - if provided, the number of THREADS in which to run
               subprocessed tests
time_out - if subprocess is True then the time limit in seconds before
           killing a test (default 30)
fake - if provided, the name of the fake tests package in the
       run_tests__tests subpackage to run instead of the normal
       pygame tests
python - the path to a python executable to run subprocessed tests
         (default sys.executable)

प्रतिलाभ की मात्रा:

A tuple of total number of tests run, dictionary of error information.
The dictionary is empty if no errors were recorded.

डिफ़ॉल्ट रूप से अलग-अलग उपप्रकारों में व्यक्तिगत परीक्षण मॉड्यूल चलाए जाते हैं। यह pygame.init() और pygame.quit() प्रोग्राम निष्पादन के अनुसार केवल एक बार कहा जाता है, और परीक्षण मॉड्यूल के बीच दुर्भाग्यपूर्ण बातचीत से बचा जाता है, जहां सामान्य pygame उपयोग को पुनः बनाता है। इसके अलावा, परीक्षण निष्पादन पर एक समय सीमा रखी गई है, इसलिए जब समय-सीमा समाप्त हो जाती है तो जमे हुए परीक्षण मारे जाते हैं। एकल प्रक्रिया विकल्प का उपयोग करें यदि थ्रेडिंग ठीक से काम नहीं कर रहा है या यदि परीक्षण बहुत लंबा हो रहा है। यह गारंटी नहीं है कि सभी परीक्षण एकल प्रक्रिया मोड में पास होंगे।

यदि यादृच्छिक तर्क सही है या बीज तर्क प्रदान किया गया है, तो परीक्षण यादृच्छिक क्रम में चलाए जाते हैं। यदि कोई बीज पूर्णांक प्रदान नहीं किया जाता है, तो सिस्टम समय का उपयोग किया जाता है।

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

यह फ़ंक्शन केवल पायथन सत्र के अनुसार एक बार बुलाया जा सकता है। यह रीटैंट नहीं है।