Navigation
index
modules
|
Autopilot 1.4.1+14.10.20140822-0 documentation
»
Global Contents
ΒΆ
Autopilot Tutorial
What is Autopilot, and what can it do?
Where is Autopilot used?
How does Autopilot fit with other test frameworks?
What do Autopilot Tests Contain?
Writing Your First Test
Files and Directories
A Minimal Test Case
The Setup Phase
Starting the Application
A Simple Test
Running Autopilot
A Test with Interaction
The Eventually Matcher
Advanced Autopilot Features
Cleaning Up
Test Scenarios
Test Logging
Environment Patching
Custom Assertions
Platform Selection
Gestures and Multitouch
Advanced Backend Picking
Default Creation
Picking a Backend
Possible Errors when Creating Backends
Keyboard Backends
A quick introduction to the Keyboard backends
Limitations of the different Keyboard backends
Process Control
Display Information
Writing Custom Proxy Classes
Writing Good Autopilot Tests
Write Expressive Tests
Test One Thing Only
Fail Well
Test Length
Good docstrings
Test Readability
Prefer
wait_for
and
Eventually
to
sleep
In Tests
In Proxy Classes
Scenarios
Multiplying Scenarios
Do Not Depend on Object Ordering
Running Autopilot
List Tests
Run Tests
Common use cases
Visualise Introspection Tree
Autopilot API Documentation
autopilot
- Global stuff
autopilot.display
- Get information about the current display(s)
autopilot.emulators
- Backwards compatibility for autopilot v1.2
autopilot.gestures
- Gestural and multi-touch support
autopilot.input
- Generate keyboard, mouse, and touch input events
Autopilot unified input system.
autopilot.introspection
- Autopilot introspection internals
Autopilot proxy type support.
autopilot.matchers
- Custom matchers for test assertions
autopilot.platform
- Functions for platform detection
Platform identification utilities for Autopilot.
Skipping tests based on Platform
autopilot.process
- Process Control
autopilot.testcase
- Base class for all Autopilot Test Cases
Quick Start
Porting Autopilot Tests
A note on Versions
Porting to Autopilot v1.4.x
Gtk Tests and Boolean Parameters
select_single
Changes
DBus backends and
DBusIntrospectionObject
changes
Python 3
Porting to Autopilot v1.3.x
QtIntrospectionTestMixin
and
GtkIntrospectionTestMixin
no longer exist
autopilot.emulators
namespace has been deprecated
Frequently Asked Questions
Autopilot: The Project
Q. Where can I get help / support?
Q. How do I install Autopilot?
Q. Where can I report a bug?
Q. What type of applications can autopilot test?
Autopilot Tests
Q. Autopilot tests often include multiple assertions. Isn’t this bad practise?
Q. How do I write a test that uses either a Mouse or a Touch device interchangeably?
Q. How do I use the Onscreen Keyboard (OSK) to input text in my test?
Autopilot Tests and Launching Applications
Q. How do I launch a Click application from within a test so I can introspect it?
Q. How do I access an already running application so that I can test/introspect it?
Autopilot Qt & Gtk Support
Q. How do I launch my application so that I can explore it with the vis tool?
Q. What is the impact on memory of adding objectNames to QML items?
Contribute
Autopilot: Contributing
Q. How can I contribute to autopilot?
Q. Where can I get help / support?
Q. How do I download the code?
Q. How do I submit the code for a merge proposal?
Q. How do I list or run the tests for the autopilot source code?
Q. Which version of Python can Autopilot use?
Q. How do I run tests with
tox
?
Appendices
XPathSelect Query Protocol
DBus Interface
Object Trees
Selecting Objects
Selecting the Root Object
Absolute Queries
Relative Queries
Mixed Queries
Attribute Queries
Wildcard Nodes
Selecting All Children
Selecting Nodes based on Attributes
Invalid Wildcard Queries
Returning State Data
Valid IDs
Special Attributes
Example GetState Return Values
Quick search
Enter search terms or a module, class or function name.
Navigation
index
modules
|
Autopilot 1.4.1+14.10.20140822-0 documentation
»