Google Git
Sign in
fuchsia / third_party / github.com / google / mobly / da7d0e60dd28ede70f80b18c20d9658ebf8a0f76
commitda7d0e60dd28ede70f80b18c20d9658ebf8a0f76[log] [tgz]
authorChris Masone <cmasone@google.com>Mon Jun 30 14:54:03 2025 -0700
committerPrashanth Swaminathan <prashanthsw@google.com>Mon Jun 30 14:54:33 2025 -0700
tree503737c116bd2d49057bdea825055ea1c8395162
parent2c9e064293769edb0e956272ac4393c1cd55de52 [diff]
Revert "[mobly] Exit non-zero on signals.TestAbortAll"

This reverts commit cf1fd01dd36b06bc06deb42b2189d3db4c28f70e.

Reason for revert: Possibly causing b/427475109

Original change's description:
> [mobly] Exit non-zero on signals.TestAbortAll
>
> Per https://github.com/google/mobly/issues/960 Mobly incorrectly exits
> either 0 or 1 when a test raises signals.TestAbortAll -- depending on
> whether any previous tests have failed or not. Instead of exiting 1 in
> the case of all tests being aborted, like any other failure, exit with
> a special code.
>
> There aren't a lot of standard codes in use, but some internal google
> docs suggest 40 for generic retryable errors. So use that.
>
> Bug: b/425675837
>
> Change-Id: I359f68a53eec703c85ea14df2d9508da74387cc8
> Reviewed-on: https://fuchsia-review.googlesource.com/c/third_party/github.com/google/mobly/+/1307184
> Reviewed-by: Prashanth Swaminathan <prashanthsw@google.com>

Bug: b/425675837
Change-Id: Ic4c86622be4940526e2c2e92179091afb66fcf6b
Reviewed-on: https://fuchsia-review.googlesource.com/c/third_party/github.com/google/mobly/+/1312365
Reviewed-by: RubberStamper 🤖 <android-build-ayeaye@system.gserviceaccount.com>
1 file changed
tree: 503737c116bd2d49057bdea825055ea1c8395162
  1. .github/
  2. docs/
  3. mobly/
  4. tests/
  5. tools/
  6. .gitignore
  7. .readthedocs.yml
  8. CHANGELOG.md
  9. CONTRIBUTING.md
  10. LICENSE
  11. pyproject.toml
  12. README.md
  13. tox.ini
README.md

Welcome to Mobly

Latest release Build Status

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 requires python 3.11 or newer.

Mobly tests could run on the following platforms:

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

System dependencies

  • adb (1.0.40+ recommended)
  • python3.11+

Installation

You can install the released package from pip

pip install mobly

or install from the source to use the bleeding edge:

git clone https://github.com/google/mobly.git
cd mobly
pip install -e .

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

Tutorials

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 version of the public Android API suitable for testing.