Google Git
Sign in
fuchsia / third_party / github.com / google / mobly / efa488ea6ea9a6e75ab2c7eb8739cbed4808c5d2
commitefa488ea6ea9a6e75ab2c7eb8739cbed4808c5d2[log] [tgz]
authorAlexander Dorokhine <adorokhine@google.com>Thu May 25 18:14:47 2017 -0700
committerGitHub <noreply@github.com>Thu May 25 18:14:47 2017 -0700
tree55a63eb01b4a1c4ba5fbbdec19d67a03b792799b
parente07849fe416baf09d23c6f1ca4d3ddda00f33db1 [diff]
Rewrite snippet management to account for new launch protocol. (#216)

* Snippet will now try and detect v1 protocol and fall back to v0 if that
  fails.
* Make snippet_client and sl4a_client responsible for bringup and teardown
  of their apks, instead of sprinkling the logic for this between
  jsonrpc_client_base, snippet_client, sl4a_client and android_device.
  This is needed because the retry structure is now different for v1
  snippets.
* Change how device port is handled. Device port comes from device side in
  v1 snippets.
* Speed up snippet startup by avoiding extra stop before starting a
  snippet.
10 files changed
tree: 55a63eb01b4a1c4ba5fbbdec19d67a03b792799b
  1. docs/
  2. mobly/
  3. tests/
  4. tools/
  5. .gitignore
  6. .travis.yml
  7. CONTRIBUTING
  8. LICENSE
  9. README.md
  10. setup.cfg
  11. setup.py
README.md

Build Status

Welcome to Mobly

Mobly is a Python-based test framework that specializes in supporting test cases that require multiple devices, complex environments, or custom hardware setups.

Here are some example use cases:

  • P2P data transfer between two devices
  • Conference calls across three phones
  • Wearable device interacting with a phone
  • Internet-Of-Things devices interacting with each other
  • Testing RF characteristics of devices with special equipment
  • Testing LTE network by controlling phones, base stations, and eNBs

Mobly can support many different types of devices and equipment, and it's easy to plug your own device or custom equipment/service into Mobly.

Mobly comes with a set of libs to control common devices like Android devices.

While developed by Googlers, Mobly is not an official Google product.

Compatibility

Mobly is compatible with both python 3.4+ and python 2.7.

Mobly tests could run on the following platforms:

  • Ubuntu 14.04+
  • MacOS 10.6+
  • Windows 7+

System dependencies

  • adb (1.0.36+ recommended)
  • python2.7 or python3.4+
  • python-setuptools

If you use Python3, use pip3 and python3 (or python3.x) accordingly.

Installation

You can install the released package from pip

$ pip install mobly

or download the source then run setup.py to use the bleeding edge:

$ git clone https://github.com/google/mobly.git
$ cd mobly
$ python setup.py install

You may need sudo for the above commands if your system has certain permission restrictions.

Tutorials

To get started with some simple tests, see the Mobly tutorial.

Mobly Snippet

The Mobly Snippet projects let users better control Android devices.

  • Mobly Snippet Lib: used for triggering custom device-side code from host-side Mobly tests. You could use existing Android libraries like UI Automator and Espresso.
  • Mobly Bundled Snippets: a set of Snippets to allow Mobly tests to control Android devices by exposing a simplified verison of the public Android API suitable for testing.