<< Chapter < Page Chapter >> Page >

Figure 2 shows that the test failed because the result of the computation did not match the specified value of 6. In this case, the output from thecomputation was correct but the value specified by the test was incorrect.

When testing using the doctest module, you specify what the result must be for the test to pass.If the test fails to produce a matching result, the output will show that the test failed. For the case of Listing 1 and Listing 2 , if the correct result had been specified, the test would simply have returned to the commandprompt with no other output.

A verbose output could have been specified in Listing 2 to cause the test to return positive results even if there were no failures. You will see howto do that in the next example.

A more substantive example

The module named Py1359_1720_02

This example will perform a test on a simple function named sum in a module named Py1359_1720_02.py as shown in Listing 3 .

Listing 3 . Contents of the file named Py1359_1720_02.py.
def sum(parA,parB): return parA + parB

The test file named Py1359_1720_02

The test file for this example is shown in Listing 4 .

Listing 4 . Contents of the test file named Py1359_1720_02.txt.
>>>from Py1359_1720_02 import sum>>>sum(2,3) 6

This file will actually cause two tests to be performed. The first test is to import the function named sum from the module named Py1359_1720_02 . However, no visible output is expected from this test. Therefore, no output is specified in Listing 4 .

The second test is to call the function named sum (shown in Listing 3 ) passing 2 and 3 as parameters. The test file shows that an incorrect output value of 6 is expected from this test. (As before, an incorrect value was specified to force the test to fail for illustration purposes only.)

The batch file named Py1359_1720_02

The batch file used to execute the test is shown in Listing 5 .

Listing 5 . Contents of the batch filenamed Py1359_1720_02.bat.
echo off rem set the pathpath=%path%;"C:\Program Files (x86)\Python34" rem perform the testpython -m doctest -v Py1359_1720_02.txt pause

This batch file differs from the one shown in Listing 2 in one respect. The -v switch following doctest in the command causes the output to be more verbose than the output from the previousexample.

The output

The execution of the third (python) command in Listing 5 produced the command line output shown in Figure 3 .

Figure 3 . Output produced by the test file named Py1359_1720_02.txt.
Trying: from Py1359_1720_02 import sumExpecting nothing okTrying: sum(2,3)Expecting: 6********************************************************************** File "Py1359_1720_02.txt", line 2, in Py1359_1720_02.txtFailed example: sum(2,3)Expected: 6Got: 5********************************************************************** 1 items had failures:1 of 2 in Py1359_1720_02.txt 2 tests in 1 items.1 passed and 1 failed. ***Test Failed*** 1 failures.

As mentioned earlier, this output is more verbose than the output shown in Figure 2 . In this more verbose output, tests that pass are shown in addition totests that fail. For example, the test of the import statement is shown as ok .

Get Jobilize Job Search Mobile App in your pocket Now!

Get it on Google Play Download on the App Store Now




Source:  OpenStax, Itse 1359 introduction to scripting languages: python. OpenStax CNX. Jan 22, 2016 Download for free at https://legacy.cnx.org/content/col11713/1.32
Google Play and the Google Play logo are trademarks of Google Inc.

Notification Switch

Would you like to follow the 'Itse 1359 introduction to scripting languages: python' conversation and receive update notifications?

Ask