Widgets and other classes to interact with tested application

The Widget base class

A Widget is often obtained with funq.client.FunqClient.widget() .

Example:

my_widget = self.funq.widget('my_widget')
class funq.models.Widget[source]

Allow to manipulate a QWidget or derived.

Variables:
  • client – client for the communication with libFunq [type: funq.client.FunqClient]
  • oid – ID of the managed C++ instance. [type: long]
  • path – complete path to the widget [type: str]
  • classes – list of class names of the managed C++ instance, in inheritance order (ie ‘QObject’ is last) [type : list(str)]
properties()[source]

Returns a dict of availables properties for this widget with associated values.

Example:

enabled = widget.properties()["enabled"]
set_properties(**properties)[source]

Define some properties on this widget.

Example:

widget.set_properties(text="My beautiful text")
set_property(name, value)[source]

Define one property on this widget.

Example:

widget.set_property('text', "My beautiful text")
wait_for_properties(props, timeout=10.0, timeout_interval=0.1)[source]

Wait for the properties to have the given values.

Example:

self.wait_for_properties({'enabled': True, 'visible': True})
click(wait_for_enabled=10.0)[source]

Click on the widget. If wait_for_enabled is > 0 (default), it will wait until the widget become active (enabled and visible) before sending click.

dclick(wait_for_enabled=10.0)[source]

Double click on the widget. If wait_for_enabled is > 0 (default), it will wait until the widget become active (enabled and visible) before sending click.

keyclick(text)[source]

Simulate keypress and keyrelease events for every character in the given text. Example:

widget.keyclick("my text")
shortcut(key_sequence)[source]

Send a shortcut on the widget, defined with a text sequence. See the QKeySequence::fromString to see the documentation of the format needed for the text sequence.

Parameters:text – text sequence of the shortcut (see QKeySequence::fromString documentation)
drag_n_drop(src_pos=None, dest_widget=None, dest_pos=None)[source]

Do a drag and drop from this widget.

Parameters:
  • src_pos – starting position of the drag. Must be a tuple (x, y) in widget coordinates or None (the center of the widget will then be used)
  • dest_widget – destination widget. If None, src_widget will be used.
  • dest_pos – ending position (the drop). Must be a tuple (x, y) in widget coordinates or None (the center of the dest widget will then be used)
close()[source]

Ask to close a widget, using QWidget::close().

call_slot(slot_name, params={})[source]

CAUTION; This methods allows to call a slot (written on the tested application). The slot must take a QVariant and returns a QVariant.

This is not really recommended to use this method, as it will trigger code in the tested application in an unusual way.

The methods returns what the slot returned, decoded as python object.

Parameters:
  • slot_name – name of the slot
  • params – parameters (must be json serialisable) that will be send to the tested application as a QVariant.
activate_focus()[source]

Activate the widget then set focus on.

Interacting with the data of QT Model/View framework

To interact with items in QAbstractTableModel, it is needed to get the associated view (QAbstractItemView). The returned instance will be of type AbstractItemView and the data will then be retrievable with the AbstractItemView.model_items() method.

Example:

view = self.funq.widget('my_tableview')
assert isinstance(view, AbstractItemView)

model_items = view.model_items()
item = model_items.item_by_named_path(['item1'])

item.dclick()

Inheritance diagram of AbstractItemView

class funq.models.AbstractItemView[source]

Specific Widget to manipulate QAbstractItemView or derived.

model_items()[source]

Returns an instance of ModelItems based on the model associated to the view.

current_editor(editor_class_name=None)[source]

Returns the editor actually opened on this view. One item must be in editing mode, by using ModelItem.dclick() or ModelItem.edit() for example.

Currently these editor types are handled: ‘QLineEdit’, ‘QComboBox’, ‘QSpinBox’ and ‘QDoubleSpinBox’.

Parameters:editor_class_name – name of the editor type. If None, every type of editor will be tested (this may actually be very slow)

Inheritance diagram of TableView

class funq.models.TableView[source]

Specific widget to manipulate a QTableView widget.

horizontal_header(timeout=2.0, timeout_interval=0.1, wait_active=True)[source]

Return the horizontal HeaderView associated to this tableview.

Each optionnal parameter is passed to funq.client.FunqClient.widget().

vertical_header(timeout=2.0, timeout_interval=0.1, wait_active=True)[source]

Return the vertical HeaderView associated to this tableview.

Each optionnal parameter is passed to funq.client.FunqClient.widget().

Inheritance diagram of TreeView

class funq.models.TreeView[source]

Specific widget to manipulate a QTreeView widget.

header(timeout=2.0, timeout_interval=0.1, wait_active=True)[source]

Return the HeaderView associated to this treeview.

Each optionnal parameter is passed to funq.client.FunqClient.widget().

class funq.models.ModelItems[source]

Allow to manipulate all modelitems in a QAbstractModelItem or derived.

Variables:items – list of ModelItem
iter()

Allow to iterate on every items recursively.

Example:

for item in items.iter():
    print item
item_by_named_path(named_path, match_column=0, sep='/', column=0)[source]

Returns the item (ModelItem) that match the arborescence defined by named_path and in the given column.

Note

The arguments are the same as for row_by_named_path(), with the addition of column.

Parameters:column – the column of the desired item
row_by_named_path(named_path, match_column=0, sep='/')[source]

Returns the item list of ModelItem that match the arborescence defined by named_path, or None if the path does not exists.

Important

Use unicode characters in named_path to match elements with non-ascii characters.

Example:

model_items.row_by_named_path([u'TG/CBO/AP (AUT 1)',
                               u'Paramètres tranche',
                               u'TG',
                               u'DANGER'])
Parameters:
  • named_path – path for the interesting ModelIndex. May be defined with a list of str or with a single str that will be splitted on sep.
  • match_column – column used to check`named_path` is a string.
class funq.models.ModelItem[source]

Allow to manipulate a modelitem in a QAbstractModelItem or derived.

Variables:
  • viewid – ID of the view attached to the model containing this item [type: long]
  • row – item row number [type: int]
  • column – item column number [type: int]
  • value – item text value [type: unicode]
  • check_state – item text value of the check state, or None
  • itempath – Internal ID to localize this item [type: str ou None]
  • items – list of subitems [type: ModelItem]
select()[source]

Select this item.

edit()[source]

Edit this item.

click(origin='center', offset_x=0, offset_y=0)[source]

Click on this item.

Parameters:
  • origin – Origin of the cursor coordinates of the ModelItem object. Availables values: “center”, “left” or “right”.
  • offset_x – x position relative to the origin. Negative value allowed.
  • offset_y – y position relative to the origin. Negative value allowed.
dclick(origin='center', offset_x=0, offset_y=0)[source]

Double click on this item.

Parameters:
  • origin – Origin of the cursor coordinates of the ModelItem object.
  • offset_x – x position relative to the origin. Negative value allowed.
  • offset_y – y position relative to the origin. Negative value allowed.
is_checkable()[source]

Returns True if the item is checkable

is_checked()[source]

Returns True if the item is checked

class funq.models.HeaderView[source]

Allow to manipulate a QHeaderView.

header_texts()[source]

Returns the list of texts in the headerview.

header_click(index_or_name)[source]

Click on the given header, identified by a visual index or a displayed name.

Interacting with the data of QT Graphics View framework

Handling QGraphicsItems data is quite similar to handling data of the Models/Views framework.

It requires the associated view (an instance of QGraphicsView). In funq the widget will be an instance of GraphicsView and the data will be available with the GraphicsView.gitems() method.

Example:

gview = self.funq.widget('my_gview')

gitems = gview.gitems()

for item in gitems.iter():
    # do something with item

Inheritance diagram of GraphicsView

class funq.models.GraphicsView[source]

Allow to manipulate an instance of QGraphicsView.

gitems()[source]

Returns an instance of GItems, that will contains every items of this QGraphicsView.

dump_gitems(stream='gitems.json')[source]

Write in a file the list of graphics items.

class funq.models.GItems[source]

Allow to manipulate a group of QGraphicsItems.

Variables:items – list of GItem that are on top of the scene (and not subitems)
iter()

Allow to iterate on every items recursively.

Example:

for item in items.iter():
    print item
class funq.models.GItem[source]

Allow to manipulate a QGraphicsItem.

Variables:
  • viewid – ID of the view attached to the model containing this item [type: long]
  • stackpath – Internal gitem ID, based on stackIndex and parent items [type: str]
  • objectname – value of the “objectName” property if it inherits from QObject. [type: unicode or None]
  • classes – list of names of class inheritance if it inherits from QObject. [type: list(str) or None]
  • items – list of subitems [type: GItem]
is_qobject()[source]

Returns True if this GItem inherits QObject

properties()[source]

Return the properties of the GItem. The GItem must inherits from QObject.

click()[source]

Click on this gitem.

dclick()[source]

Double click on this gitem.

Other widgets

Inheritance diagram of TabBar

class funq.models.TabBar[source]

Allow to manipulate a QTabBar Widget.

tab_texts()[source]

Returns the list of texts in tabbar.

set_current_tab(tab_index_or_name)[source]

Define the current tab given an index or a tab text.

Inheritance diagram of ComboBox

class funq.models.ComboBox[source]

Allow to manipulate a QCombobox.

model_items()[source]

Returns the items (ModelItems) associated to this combobox.

set_current_text(text)[source]

Define the text of the combobox, ensuring that it is a possible value.