PyCharm 2.7.2 Web Help

The Test Runner tab opens in the Run tool window when a testing session begins, and features the same toolbar buttons.

py_test_runner_tab
Click thumbnail to view larger image.

  1. The progress bar shows the percentage of tests executed so far.
  2. 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.
  3. 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 status of each test is indicated by an icon. Double-click a node to open the respective test class or test method in the editor.
  4. 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.
  5. The Output pane shows the output of the current test suit.
  6. The Statistics pane shows the list of executed tests with the time used for executing each test and the test result.

Run Toolbar

ItemTooltip and ShortcutDescription
rerun Rerun
Ctrl+F5Ctrl+F5Ctrl+5Ctrl+F5Ctrl+F5Ctrl+Alt+RCtrl+F5Ctrl+F5Control F5Control F5Control F5		Click this button to rerun the current process.

Note

The process reruns always in the same console regardless of whether this console is pinned or not.

rerunFailedTests.pngRerun Failed TestsClick this button to have PyCharm execute all the tests that failed.
icon_toggleAutoTest Toggle auto-testIf this button is pressed, the autotest-like runner is turned on. It means that the test in the current run configuration tab will automatically rerun on changing its source code. Otherwise, to rerun such test, you have to click the rerun button rerun.
stop Stop
Ctrl+F2Ctrl+F2Ctrl+2Ctrl+F2Ctrl+F2Shift+F5Shift+F5 or Ctrl+Shift+DeleteCtrl+F2Meta F2Meta F2Meta F2		Click this button to terminate the current process externally by means of the standard mechanisms.
debug_layout.gif LayoutClick this button to choose a layout of the toolbars by selecting the desired option from the pop-up menu.
pin2.png PinWhen this button is pressed, the current tab will not be overwritten; instead, the results of the next command will be displayed in a new tab.
close.png Ctrl+Shift+F4Ctrl+Shift+F4Ctrl+Shift+4Ctrl+Shift+F4Ctrl+Shift+F4Ctrl+Shift+F4Ctrl+Shift+F4Ctrl+WMeta Shift F4Meta Shift F4Meta W Click this button to close the selected tab of the Run tool window and terminate the current process.
help.gif F1F1F1F1F1F1F1F1F1F1F1 Click this button to show reference.

Testing Toolbar

ItemTooltip
and Shortcut 		Description
junitHidePassedIcon.png Hide PassedPress 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.
sortAlphabeticallySort alphabeticallyClick this button to sort tests in alphabetical order.
expandAll.png collapseAll Expand All/Collapse All
Ctrl+NumPad + or Ctrl+EqualsCtrl+NumPad + or Ctrl+EqualsCtrl+NumPad + or Ctrl+EqualsCtrl+NumPad + or Ctrl+EqualsCtrl+NumPad + or Ctrl+EqualsCtrl+NumPad + or Ctrl+EqualsCtrl+NumPad + or Ctrl+EqualsCtrl+NumPad + or Ctrl+EqualsMeta NumPad or Meta EqualsMeta NumPad or Meta EqualsMeta NumPad or Meta EqualsCtrl+NumPad - or Ctrl+MinusCtrl+NumPad - or Ctrl+MinusCtrl+NumPad - or Ctrl+MinusCtrl+NumPad - or Ctrl+MinusCtrl+NumPad - or Ctrl+MinusCtrl+NumPad - or Ctrl+MinusCtrl+NumPad - or Ctrl+MinusCtrl+NumPad - or Ctrl+MinusMeta NumPad - or Meta MinusMeta NumPad - or Meta MinusMeta NumPad - or Meta Minus		Click these buttons to have all nodes in the tree view of tests expanded.

Note

These buttons are only available if the tested application contains more than test case.

arrowUp.pngarrowDown.png Previous/Next Failed Test
Ctrl+Alt+Up/Ctrl+Alt+Down		Click this button to navigate between the failed tests.
exportToTextFile.png 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.
projectToolWindowSettingsIcon.png Click this cog button to access the context menu with the following options:
  • Track Running Test: turn this option on to monitor execution of the current test. If a test suite contains multiple tests, the tree view of tests expands to show sequential test methods, as they are executed.
  • Hide Ignored: turn this option on to suppress showing ignored tests in the tree view of all tests within the current run/debug configuration or test class.
  • Select First Failed Test When Finished: turn this option on to have the first failed test automatically selected in the tree view upon completing the tests.
  • Scroll to Stacktrace: turn this option on to have the console scroll to the beginning of the trace of the last failed test.
    If you click the root node (the test package) in the tree view with this option turned off, the console will show the very beginning of the test.

    Tip

    This option is helpful when a test package contains multiple test classes and test methods. If some of the tests fail, you can scroll in the console to the beginning of a stack trace of an exception or assertion.

  • Autoscroll to Source: turn this option on to have the currently selected test in the tree view synchronized with the editor automatically.
  • Open Source at Exception: use this option to explore the results of a test that fails as an error, throwing an uncaught exception.
    If you double-click the failed test class or method in the tree view with this option turned on, the respective test class or method will open in the editor, with the caret placed at the line that caused the problem.
  • Show Statistics: turn this option on to have the Statistics pane opened, displaying a list of executed tests with the time used for executing each test and the test result.

Test Status Icons

IconDescription
testError.png Test error. This status is assigned to tests that caused an exception from the tested source code.
testFailed.png Test failed. If at least one test receives this status, the entire tree is marked as terminated as well.
testIgnored.png Test ignored.
testInProgress1.png Test in progress.
testPassed.png Test passed successfully.
testPaused.png Test paused.
testTerminated.png Test terminated. This status is assigned to tests that were cancelled by clicking the Stop button stop.png. If at least one test receives this status, the entire tree is marked as terminated as well.
testNotRan.png 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 stop.png.

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.

ItemKeyboard ShortcutDescription
arrowUp 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.
arrowDown 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.
icon_softWrap Use Soft Wraps Click this button to toggle the soft wrap mode of the output.
scrollToEnd.png 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.
print.png Print Click this button to configure printing out the console output in the Print dialog box that opens.
Clear AllChoose this item on the context menu to have all messages for the selected test deleted.
Copy Content Ctrl+C or Ctrl+InsertCtrl+C or Ctrl+InsertCtrl+C or Ctrl+InsertCtrl+C or Ctrl+InsertCtrl+Insert, Alt+C or Escape, WCtrl+C or Ctrl+InsertCtrl+C or Ctrl+InsertCtrl+C or Ctrl+InsertMeta C or Meta InsertMeta C or Meta InsertMeta C or Meta Insert Choose this item on the context menu to have the current contents of the Output pane placed to the Clipboard.
Compare with ClipboardChoose 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 nameDescription
TestName of the test class or test method.
Time elapsedThe number of seconds spent to to execute this test.
ResultsThis 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

CommandKeyboard shortcutDescription
View assertEquals Difference Alt+EnterAlt+EnterAlt+EnterAlt+EnterAlt+EnterAlt+EnterAlt+EnterAlt+Enter, Alt+Shift+J or Ctrl+Shift+MAlt EnterAlt EnterMeta 1 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+F10Ctrl+Shift+F10Ctrl+Shift+F10Ctrl+Shift+F10Ctrl+Shift+F10Ctrl+F9Alt+Shift+F6 or Shift+F6Ctrl+Shift+F10Control Shift F10Control Shift F10Control Shift R Run the selected test and collect coverage data in accordance with the current temporary run/debug configuration.
Jump to Source F4F4F4F4F4F4F4F12 or Ctrl+Shift+EF4F4F3 Choose this command to move the focus to the editor, to the definition of a test class, or test method.

See Also

Procedures:

Reference:

Web Resources: