https://github.com/google/mobly

E2E test framework for tests with complex environment requirements.
https://github.com/google/mobly

android android-app android-development android-devices android-test android-wear automation bluetooth cars google mobile networking phone python robotics telephony test-automation testing wifi windows

Last synced: 6 days ago
JSON representation

E2E test framework for tests with complex environment requirements.

• Host: GitHub
• URL: https://github.com/google/mobly
• Owner: google
• License: apache-2.0
• Created: 2016-11-07T17:45:31.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2024-12-10T12:11:25.000Z (13 days ago)
• Last Synced: 2024-12-10T14:05:21.348Z (13 days ago)
• Topics: android, android-app, android-development, android-devices, android-test, android-wear, automation, bluetooth, cars, google, mobile, networking, phone, python, robotics, telephony, test-automation, testing, wifi, windows
• Language: Python
• Homepage: https://github.com/google/mobly
• Size: 2.91 MB
• Stars: 656
• Watchers: 52
• Forks: 178
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Welcome to Mobly

[![Latest release](https://img.shields.io/github/release/google/mobly.svg)](https://github.com/google/mobly/releases/latest)

[![Build Status](https://github.com/google/mobly/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/google/mobly/actions)

**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

```sh

pip install mobly

```

or install from the source to use the bleeding edge:

```sh

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 101](docs/tutorial.md) -

Simple test examples to get you started with Mobly.

* [Mobly Instrumentation Runner Tutorial](docs/instrumentation_tutorial.md) -

How to use Mobly's Android instrumentation test runner to run Android instrumentation tests.

* [Mobly AndroidDevice Service](docs/android_device_service.md) -

Create custom service to attach to Mobly's `AndroidDevice` controller.

## Mobly Snippet

The Mobly Snippet projects let users better control Android devices.

* [Mobly Snippet Lib](https://github.com/google/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](https://github.com/google/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.