summaryrefslogtreecommitdiff
path: root/tests/README
blob: 109cb1802a79fd9aa0110f21032c352c0e911a24 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

Testing AT-SPI requires both a test application and an AT client.

Test applications are built from xml files using xml loader module,
based on Dummy ATK implementation.

Each test is built as a GTest object and packed into a single interface test suite.

Test directory contains:

 * atk_suite - Generates a test suite, the main executable of all test suite,
               help is shown when run with '-h' parameter.

 * atk-object-xml-loader - Generates dummy atk object from xml file.

 * test-application - Starts an application with atk object generated by atk-object-xml-loader

 * data/ - Folder which contains xml file from which dummy atk object is generated

 * dummyatk/ - Folder which contains dummy atk implementation


************************
HOW TO CREATE NEW TESTS:

1) Add atspi interface which will be tested to Atk_Test_Case in atk_suite.c and atk_suite.h,
   then add proper test call in atk_suite_build function.
2) Prepare xml file which describes tested root object and descendants.
   If any new fields in xml file appear, atk-object-xml-loader should be modifed.
3) Add test file named atk_test_TEST_NAME.c, where TEST_NAME is tested interface name:
   a) Create function which runs tested application
   b) Create get_root_obj function for tested interface
   c) Create tested functions
   d) Create function which calls all test functions, this function should be called in atk_suite.c file.

*************************
AVAILABLE TESTS:

- Accessible:
             -accessible_get_name
             -accessible_get_description
             -accessible_get_child_count
             -accessible_get_parent
             -accessible_get_child_at_index
             -accessible_get_index_in_parent
             -accessible_get_relation_set_1
             -accessible_get_relation_set_2
             -accessible_get_role
             -accessible_get_role_name
             -accessible_get_localized_role_name
             -accessible_get_state_set
             -accessible_get_attributes
             -accessible_get_attributes_as_array
             -accessible_get_toolkit_name
             -accessible_get_toolkit_version
             -accessible_get_atspi_version
             -accessible_get_id
             -accessible_get_application
             -accessible_get_action_iface
             -accessible_get_collection_iface
             -accessible_get_component_iface
             -accessible_get_document_iface
             -accessible_get_editable_text_iface
             -accessible_get_hypertext_iface
             -accessible_get_image_iface
             -accessible_get_selection_iface
             -accessible_get_table_iface
             -accessible_get_text_iface
             -accessible_get_value_iface
             -accessible_get_interfaces
             -accessible_get_object_locale
             -accessible_set_cache_mask
             -accessible_clear_cache
             -accessible_get_process_id
- Action:
             -get_action_interface
             -action_get_action_description
             -action_get_action_name
             -action_get_n_actions
             -action_get_key_binding
             -action_get_localized_name
             -action_do_action
- Component:
             -component_contains
             -component_get_accessible_at_point
             -component_get_extents
             -component_get_layer
             -component_get_mdi_z_order
             -component_grab_focus
             -component_get_alpha
             -component_set_extents