Google Git
Sign in
fuchsia/third_party/github.com/google/mobly/refs/heads/upstream/add-adb-spawn-and-stream
commit
1367ef66aa555f463f2e814a68969ef7c1ec9704
[log]
author
Ang Li <angli@google.com>
Sat Aug 08 21:26:54 2026 +0000
committer
Ang Li <angli@google.com>
Sun Aug 09 00:18:40 2026 +0000
tree
aa8e7ce0089aba808bff75d21b4077532bffb31a
parent
09221a517661be95440184f3e82b066465f7575e [diff]
feat(adb): add spawn and stream parameters to AdbProxy (#446)

Add support for long-running and streaming ADB commands directly via
parameter flags on AdbProxy dynamic method dispatches (e.g. adb.shell(..., spawn=True),
adb.logcat(..., stream=True)).

- Introduce AdbProcess wrapping subprocess.Popen with process lifecycle
  methods (poll, wait, stop, iter_lines) and context manager support.
- Add _spawn_cmd to AdbProxy and update __getattr__ to support spawn=True
  and stream=True.
- Validate that timeout cannot be passed when spawn=True, delegating timeout
  control cleanly to AdbProcess.wait(timeout=...).
- Add comprehensive unit tests for AdbProcess and AdbProxy spawn/stream execution.

Closes #446

ORIGINAL_AUTHOR=angli
2 files changed
tree: aa8e7ce0089aba808bff75d21b4077532bffb31a
  1. .github/
  2. docs/
  3. mobly/
  4. tests/
  5. tools/
  6. .gitignore
  7. .readthedocs.yaml
  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.