In this section:
Basics
The Test Runner tab opens in the Run tool window when a testing session begins, and features the same toolbar buttons.
Click thumbnail to view larger image.
- The progress bar shows the percentage of tests executed so far.
- The color of the status bar indicates whether the tests have passed successfully. If at least one of the tests fails, the status bar turns red.
- The left-hand pane shows the tree view of all tests within the current run/debug
configuration.
- The root node represents the test case selected to run.
- The nested nodes represent the hierarchy of test suites and test cases.
- The leaf nodes represent the individual tests.
- The testing toolbar provides controls that enable you to monitor the tests and analyze results. Some of the commands are duplicated on the context menus of the test tree nodes and the entries in the Statistics pane.
- The Output pane shows the output of the current test suit.
- The Statistics pane shows the list of executed tests with the time used for executing each test and the test result.
Run toolbar
Testing toolbar
Item | Tooltip and Shortcut | Description |
---|---|---|
![]() | Hide Passed | Press this button, to have PyCharm show only the failed tests or the tests that encountered problems in the left-hand pane. If this button is not pressed, all tests are displayed in the tree view. |
![]() | Sort alphabetically | Click this button to sort tests in alphabetical order. |
![]() ![]() | Expand All/Collapse All Ctrl+NumPad Plus or Ctrl+Equals Ctrl+NumPad - or Ctrl+Minus | Click these buttons to have all nodes in the tree view of tests expanded.
These buttons are only available if the tested application contains more than test case. |
![]() ![]() | Previous/Next Failed Test Ctrl+Alt+Up/Ctrl+Alt+Down | Click this button to navigate between the failed tests. |
![]() | Export Test Results | Click this button to have the results of the selected test saved in a file. IN the Export Test Results that opens, specify the file to save the output in and the format in which the data will be saved. |
![]() | Click this cog button to access the context menu with the following options:
|
Test status icons
Icon | Description |
---|---|
![]() | Test error. This status is assigned to tests that caused an exception from the tested source code. |
![]() | Test failed. If at least one test receives this status, the entire tree is marked as terminated as well. |
![]() | Test ignored. |
![]() | Test in progress. |
![]() | Test passed successfully. |
![]() | Test paused. |
![]() | Test terminated. This status is assigned to tests that were cancelled by clicking the Stop button ![]() |
![]() | Test not run. This status is assigned to a test when PyCharm has not launched it at all, for example,
because testing was terminated by clicking the Stop button ![]() |
Output pane
This pane shows output of each test, generated at runtime, including all the messages sent to the output stream, and the error messages. The following table shows the toolbar buttons and context menu commands available for the Output pane.
Item | Keyboard Shortcut | Description |
---|---|---|
![]() | Up the Stack Trace Ctrl+Alt+Up | Click this button to navigate up in the stack trace and have the cursor jump to the corresponding location in the source code. |
![]() | Down the Stack Trace Ctrl+Alt+Down | Click this button to navigate down in the stack trace and have the cursor jump to the corresponding location in the source code. |
![]() | Use Soft Wraps | Click this button to toggle the soft wrap mode of the output. |
![]() | Scroll to the end | Click this button to navigate to the bottom of the stack trace and have the cursor jump to the corresponding location in the source code. |
![]() | Click this button to configure printing out the console output in the Print dialog box that opens. | |
Clear All | Choose this item on the context menu to have all messages for the selected test deleted. | |
Copy Content | Ctrl+C or Ctrl+Insert | Choose this item on the context menu to have the current contents of the Output pane placed to the Clipboard. |
Compare with Clipboard | Choose this item on the context menu to invoke the Differences Viewer which shows the current contents of the Clipboard in the left-hand pane and the contents of the Output pane for the selected test in the right-hand pane. pane. |
Statistics pane
This pane shows how long it took to execute a test suite and the number of passed and failed tests within it. You can have information in columns shown in the ascending or descending order by clicking the column headers.
To view statistics on each test separately, double click the test suite which contains the desired test. The pane shows a list of all the tests in the selected suit.
The Context menu commands are the same as for the tree view of tests.
Column name | Description |
---|---|
Test | Name of the test class or test method. |
Time elapsed | The number of seconds spent to to execute this test. |
Results | This column shows summary information about the test execution results. For individual tests, the column shows the pass or fail status. For test case or test suites, the column shows the number of failed and passed tests within it. |
Context menu commands
Command | Keyboard shortcut | Description |
---|---|---|
View assertEquals Difference | Alt+Enter | Choose this command to show the Differences viewer for the strings being compared. This command is only available when assertion has failed. |
Run <test name> with Coverage | Ctrl+Shift+F10 | Run the selected test and collect coverage data in accordance with the current temporary run/debug configuration. |
Jump to Source | F4 | Choose this command to move the focus to the editor, to the definition of a test class, or test method. |
Show Source | Ctrl+Enter | Choose this command to open source code in the editor, but leave the focus with the Test Runner tab. |
Show Statistics | Choose this command to open the Statistics pane if it is closed. |