Back to index

unity  6.0.0
Public Member Functions | Public Attributes | Static Public Attributes
unity.tests.test_panel.PanelKeyNavigationTests Class Reference
Inheritance diagram for unity.tests.test_panel.PanelKeyNavigationTests:
Inheritance graph
[legend]
Collaboration diagram for unity.tests.test_panel.PanelKeyNavigationTests:
Collaboration graph
[legend]

List of all members.

Public Member Functions

def get_active_indicator
def test_panel_first_menu_show_works
def test_panel_menu_accelerators_work
def test_panel_indicators_key_navigation_next_works
def test_panel_indicators_key_navigation_prev_works
def test_mouse_does_not_break_key_navigation
def setUp
def open_new_application_window
def move_window_to_panel_monitor
def mouse_open_indicator
def assert_win_buttons_in_overlay_mode
def assert_no_window_open_with_xid
def sleep_menu_settle_period
def check_test_behavior
def dash
def hud
def launcher
def panels
def switcher
def window_manager
def workspace
def set_unity_log_level
def assertNumberWinsIsEventually

Public Attributes

 panel

Static Public Attributes

tuple scenarios = _make_monitor_scenarios()
int panel_monitor = 0

Detailed Description

Definition at line 951 of file test_panel.py.


Member Function Documentation

Assert that Bamf doesn't know of any open windows with the given xid.

Definition at line 129 of file test_panel.py.

00129 
00130     def assert_no_window_open_with_xid(self, x_id):
00131         """Assert that Bamf doesn't know of any open windows with the given xid."""
00132         # We can't check text_win.closed since we've just destroyed the window.
00133         # Instead we make sure no window with it's x_id exists.
00134         refresh_fn = lambda: [w for w in self.bamf.get_open_windows() if w.x_id == x_id]
00135         self.assertThat(refresh_fn, Eventually(Equals([])))

Here is the caller graph for this function:

def unity.tests.test_panel.PanelTestsBase.assert_win_buttons_in_overlay_mode (   self,
  overlay_mode 
) [inherited]
Assert that there are three panel window buttons and all of them are
in the specified overlay mode.

Definition at line 116 of file test_panel.py.

00116 
00117     def assert_win_buttons_in_overlay_mode(self, overlay_mode):
00118         """Assert that there are three panel window buttons and all of them are
00119         in the specified overlay mode.
00120 
00121         """
00122         if type(overlay_mode) is not bool:
00123             raise TypeError("overlay_mode must be True or False")
00124 
00125         buttons = self.panel.window_buttons.get_buttons()
00126         self.assertThat(len(buttons), Equals(3))
00127         for button in buttons:
00128             self.assertThat(button.overlay_mode, Eventually(Equals(overlay_mode)))

Here is the caller graph for this function:

def unity.tests.UnityTestCase.assertNumberWinsIsEventually (   self,
  app,
  num 
) [inherited]
Asserts that 'app' eventually has 'num' wins. Waits up to 10 seconds.

Definition at line 196 of file __init__.py.

00196 
00197     def assertNumberWinsIsEventually(self, app, num):
00198         """Asserts that 'app' eventually has 'num' wins. Waits up to 10 seconds."""
00199 
00200         self.assertThat(lambda: len(app.get_windows()), Eventually(Equals(num)))

Here is the caller graph for this function:

Fail the test if it did something naughty.

This includes leaving the dash or the hud open, changing the current
workspace, or leaving the system in show_desktop mode.

Definition at line 56 of file __init__.py.

00056 
00057     def check_test_behavior(self):
00058         """Fail the test if it did something naughty.
00059 
00060         This includes leaving the dash or the hud open, changing the current
00061         workspace, or leaving the system in show_desktop mode.
00062 
00063         """
00064         well_behaved = True
00065         reasons = []
00066         log.info("Checking system state for badly behaving test...")
00067 
00068         # Have we switched workspace?
00069         if self.workspace.current_workspace != self._initial_workspace_num:
00070             well_behaved = False
00071             reasons.append("The test changed the active workspace from %d to %d." \
00072                 % (self._initial_workspace_num, self.workspace.current_workspace))
00073             log.warning("Test changed the active workspace, changing it back...")
00074             self.workspace.switch_to(self._initial_workspace_num)
00075         # Have we left the dash open?
00076         if self.dash.visible:
00077             well_behaved = False
00078             reasons.append("The test left the dash open.")
00079             log.warning("Test left the dash open, closing it...")
00080             self.dash.ensure_hidden()
00081         # ... or the hud?
00082         if self.hud.visible:
00083             well_behaved = False
00084             reasons.append("The test left the hud open.")
00085             log.warning("Test left the hud open, closing it...")
00086             self.hud.ensure_hidden()
00087         # Are we in show desktop mode?
00088         if self.window_manager.showdesktop_active:
00089             well_behaved = False
00090             reasons.append("The test left the system in show_desktop mode.")
00091             log.warning("Test left the system in show desktop mode, exiting it...")
00092             self.window_manager.leave_show_desktop()
00093         for launcher in self.launcher.get_launchers():
00094             if launcher.in_keynav_mode:
00095                 well_behaved = False
00096                 reasons.append("The test left the launcher keynav mode enabled.")
00097                 log.warning("Test left the launcher in keynav mode, exiting it...")
00098                 launcher.key_nav_cancel()
00099             if launcher.in_switcher_mode:
00100                 well_behaved = False
00101                 reasons.append("The test left the launcher in switcher mode.")
00102                 log.warning("Test left the launcher in switcher mode, exiting it...")
00103                 launcher.switcher_cancel()
00104 
00105         if not well_behaved:
00106             self.fail("/n".join(reasons))
00107         else:
00108             log.info("Test was well behaved.")

def unity.tests.UnityTestCase.dash (   self) [inherited]

Definition at line 110 of file __init__.py.

00110 
00111     def dash(self):
00112         if not getattr(self, '__dash', None):
00113             self.__dash = Dash()
00114         return self.__dash

Get the active indicator in a safe manner.

This method will wait until the active indicator has been set.

Definition at line 955 of file test_panel.py.

00955 
00956     def get_active_indicator(self):
00957         """Get the active indicator in a safe manner.
00958 
00959         This method will wait until the active indicator has been set.
00960 
00961         """
00962         self.assertThat(self.panel.get_active_indicator, Eventually(NotEquals(None)))
00963         return self.panel.get_active_indicator()

Here is the caller graph for this function:

def unity.tests.UnityTestCase.hud (   self) [inherited]

Definition at line 116 of file __init__.py.

00116 
00117     def hud(self):
00118         if not getattr(self, '__hud', None):
00119             self.__hud = Hud();
00120         return self.__hud

def unity.tests.UnityTestCase.launcher (   self) [inherited]

Definition at line 122 of file __init__.py.

00122 
00123     def launcher(self):
00124         if not getattr(self, '__launcher', None):
00125             self.__launcher = self._get_launcher_controller()
00126         return self.__launcher

def unity.tests.test_panel.PanelTestsBase.mouse_open_indicator (   self,
  indicator 
) [inherited]
This is an utility function that safely opens an indicator,
ensuring that it is closed at the end of the test and that the pointer
is moved outside the panel area (to make the panel hide the menus)

Definition at line 103 of file test_panel.py.

00103 
00104     def mouse_open_indicator(self, indicator):
00105         """This is an utility function that safely opens an indicator,
00106         ensuring that it is closed at the end of the test and that the pointer
00107         is moved outside the panel area (to make the panel hide the menus)
00108         """
00109         if not isinstance(indicator, IndicatorEntry):
00110             raise TypeError("Window must be a IndicatorEntry")
00111 
00112         indicator.mouse_click()
00113         self.addCleanup(self.panel.move_mouse_below_the_panel)
00114         self.addCleanup(self.keyboard.press_and_release, "Escape")
00115         self.assertThat(indicator.active, Eventually(Equals(True)))

Here is the caller graph for this function:

def unity.tests.test_panel.PanelTestsBase.move_window_to_panel_monitor (   self,
  window,
  restore_position = False 
) [inherited]
Drags a window to another monitor, eventually restoring it before

Definition at line 83 of file test_panel.py.

00083 
00084     def move_window_to_panel_monitor(self, window, restore_position=False):
00085         """Drags a window to another monitor, eventually restoring it before"""
00086         if not isinstance(window, BamfWindow):
00087             raise TypeError("Window must be a BamfWindow")
00088 
00089         if window.monitor == self.panel_monitor:
00090             return
00091 
00092         if window.is_maximized:
00093             self.keybinding("window/restore")
00094             self.addCleanup(self.keybinding, "window/maximize")
00095             sleep(.1)
00096 
00097         if restore_position:
00098             self.addCleanup(self.screen_geo.drag_window_to_monitor, window, window.monitor)
00099 
00100         self.screen_geo.drag_window_to_monitor(window, self.panel_monitor)
00101         sleep(.25)
00102         self.assertThat(window.monitor, Equals(self.panel_monitor))

Here is the caller graph for this function:

def unity.tests.test_panel.PanelTestsBase.open_new_application_window (   self,
  app_name,
  maximized = False,
  move_to_monitor = True 
) [inherited]
Opens a new instance of the requested application, ensuring that only
one window is opened.

Returns the opened BamfWindow

Definition at line 49 of file test_panel.py.

00049 
00050     def open_new_application_window(self, app_name, maximized=False, move_to_monitor=True):
00051         """Opens a new instance of the requested application, ensuring that only
00052         one window is opened.
00053 
00054         Returns the opened BamfWindow
00055 
00056         """
00057         self.close_all_app(app_name)
00058         app = self.start_app(app_name, locale="C")
00059 
00060         [app_win] = app.get_windows()
00061 
00062         app_win.set_focus()
00063         self.assertTrue(app.is_active)
00064         self.assertTrue(app_win.is_focused)
00065         self.assertThat(app.desktop_file, Equals(app_win.application.desktop_file))
00066 
00067         if move_to_monitor:
00068             self.move_window_to_panel_monitor(app_win)
00069 
00070         if maximized and not app_win.is_maximized:
00071             self.keybinding("window/maximize")
00072             self.addCleanup(self.keybinding, "window/restore")
00073         elif not maximized and app_win.is_maximized:
00074             self.keybinding("window/restore")
00075             self.addCleanup(self.keybinding, "window/maximize")
00076 
00077         app_win.set_focus()
00078         sleep(.25)
00079 
00080         self.assertThat(app_win.is_maximized, Equals(maximized))
00081 
00082         return app_win

Here is the call graph for this function:

def unity.tests.UnityTestCase.panels (   self) [inherited]

Definition at line 128 of file __init__.py.

00128 
00129     def panels(self):
00130         if not getattr(self, '__panels', None):
00131             self.__panels = self._get_panel_controller()
00132         return self.__panels

def unity.tests.UnityTestCase.set_unity_log_level (   self,
  component,
  level 
) [inherited]
Set the unity log level for 'component' to 'level'.

Valid levels are: TRACE, DEBUG, INFO, WARNING and ERROR.

Components are dotted unity component names. The empty string specifies
the root logging component.

Definition at line 183 of file __init__.py.

00183 
00184     def set_unity_log_level(self, component, level):
00185         """Set the unity log level for 'component' to 'level'.
00186 
00187         Valid levels are: TRACE, DEBUG, INFO, WARNING and ERROR.
00188 
00189         Components are dotted unity component names. The empty string specifies
00190         the root logging component.
00191         """
00192         valid_levels = ('TRACE', 'DEBUG', 'INFO', 'WARN', 'WARNING', 'ERROR')
00193         if level not in valid_levels:
00194             raise ValueError("Log level '%s' must be one of: %r" % (level, valid_levels))
00195         set_log_severity(component, level)

Here is the call graph for this function:

Here is the caller graph for this function:

def unity.tests.test_panel.PanelTestsBase.setUp (   self) [inherited]

Reimplemented from unity.tests.UnityTestCase.

Reimplemented in unity.tests.test_panel.PanelCrossMonitorsTests, and unity.tests.test_panel.PanelWindowButtonsTests.

Definition at line 43 of file test_panel.py.

00043 
00044     def setUp(self):
00045         super(PanelTestsBase, self).setUp()
00046         self.panel = self.panels.get_panel_for_monitor(self.panel_monitor)
00047         self.panel.move_mouse_below_the_panel()
00048         self.addCleanup(self.panel.move_mouse_below_the_panel)

Sleep long enough for the menus to fade in and fade out again.

Definition at line 136 of file test_panel.py.

00136 
00137     def sleep_menu_settle_period(self):
00138         """Sleep long enough for the menus to fade in and fade out again."""
00139         sleep(self.panel.menus.fadein_duration / 1000.0)
00140         sleep(self.panel.menus.discovery_duration)
00141         sleep(self.panel.menus.fadeout_duration / 1000.0)
00142 

Here is the caller graph for this function:

def unity.tests.UnityTestCase.switcher (   self) [inherited]

Definition at line 134 of file __init__.py.

00134 
00135     def switcher(self):
00136         if not getattr(self, '__switcher', None):
00137             self.__switcher = Switcher()
00138         return self.__switcher

Must be able to use the mouse to open indicators after they've been
opened with the keyboard.

Definition at line 1015 of file test_panel.py.

01015 
01016     def test_mouse_does_not_break_key_navigation(self):
01017         """Must be able to use the mouse to open indicators after they've been
01018         opened with the keyboard.
01019         """
01020         self.open_new_application_window("Calculator")
01021         available_indicators = self.panel.get_indicator_entries(include_hidden_menus=True)
01022 
01023         self.keybinding("panel/open_first_menu")
01024         self.addCleanup(self.keyboard.press_and_release, "Escape")
01025 
01026         available_indicators[2].mouse_move_to()
01027         self.addCleanup(self.panel.move_mouse_below_the_panel)
01028 
01029         self.assertThat(available_indicators[2].active, Eventually(Equals(True)))
01030 
01031         self.keybinding("panel/prev_indicator")
01032         self.assertThat(available_indicators[1].active, Eventually(Equals(True)))
01033 

Here is the call graph for this function:

Pressing the open-menus keybinding must open the first indicator.

Definition at line 964 of file test_panel.py.

00964 
00965     def test_panel_first_menu_show_works(self):
00966         """Pressing the open-menus keybinding must open the first indicator."""
00967         self.open_new_application_window("Calculator")
00968         sleep(1)
00969         self.keybinding("panel/open_first_menu")
00970         self.addCleanup(self.keyboard.press_and_release, "Escape")
00971 
00972         open_indicator = self.get_active_indicator()
00973         expected_indicator = self.panel.get_indicator_entries(include_hidden_menus=True)[0]
00974         self.assertThat(open_indicator.entry_id, Eventually(Equals(expected_indicator.entry_id)))
00975 
00976         self.keybinding("panel/open_first_menu")
00977         self.assertThat(self.panel.get_active_indicator(), Eventually(Equals(None)))

Here is the call graph for this function:

Right arrow key must open the next menu.

Definition at line 988 of file test_panel.py.

00988 
00989     def test_panel_indicators_key_navigation_next_works(self):
00990         """Right arrow key must open the next menu."""
00991         self.open_new_application_window("Calculator")
00992         available_indicators = self.panel.get_indicator_entries(include_hidden_menus=True)
00993 
00994         self.keybinding("panel/open_first_menu")
00995         self.addCleanup(self.keyboard.press_and_release, "Escape")
00996 
00997         self.keybinding("panel/next_indicator")
00998         open_indicator = self.get_active_indicator()
00999         expected_indicator = available_indicators[1]
01000         self.assertThat(open_indicator.entry_id, Eventually(Equals(expected_indicator.entry_id)))

Here is the call graph for this function:

Left arrow key must open the previous menu.

Definition at line 1001 of file test_panel.py.

01001 
01002     def test_panel_indicators_key_navigation_prev_works(self):
01003         """Left arrow key must open the previous menu."""
01004         self.open_new_application_window("Calculator")
01005         available_indicators = self.panel.get_indicator_entries(include_hidden_menus=True)
01006 
01007         self.keybinding("panel/open_first_menu")
01008         self.addCleanup(self.keyboard.press_and_release, "Escape")
01009 
01010         self.keybinding("panel/prev_indicator")
01011         open_indicator = self.get_active_indicator()
01012         expected_indicator = available_indicators[-1]
01013 
01014         self.assertThat(open_indicator.entry_id, Eventually(Equals(expected_indicator.entry_id)))

Here is the call graph for this function:

Pressing a valid menu accelerator must open the correct menu item.

Definition at line 978 of file test_panel.py.

00978 
00979     def test_panel_menu_accelerators_work(self):
00980         """Pressing a valid menu accelerator must open the correct menu item."""
00981         self.open_new_application_window("Calculator")
00982         sleep(1)
00983         self.keyboard.press_and_release("Alt+c")
00984         self.addCleanup(self.keyboard.press_and_release, "Escape")
00985 
00986         open_indicator = self.get_active_indicator()
00987         self.assertThat(open_indicator.label, Eventually(Equals("_Calculator")))

Here is the call graph for this function:

def unity.tests.UnityTestCase.window_manager (   self) [inherited]

Definition at line 140 of file __init__.py.

00140 
00141     def window_manager(self):
00142         if not getattr(self, '__window_manager', None):
00143             self.__window_manager = self._get_window_manager()
00144         return self.__window_manager

def unity.tests.UnityTestCase.workspace (   self) [inherited]

Definition at line 146 of file __init__.py.

00146 
00147     def workspace(self):
00148         if not getattr(self, '__workspace', None):
00149             self.__workspace = WorkspaceManager()
00150         return self.__workspace


Member Data Documentation

Definition at line 45 of file test_panel.py.

Reimplemented in unity.tests.test_panel.PanelCrossMonitorsTests.

Definition at line 41 of file test_panel.py.

Definition at line 953 of file test_panel.py.


The documentation for this class was generated from the following file: