Project: mobly (GitHub Link)

mobly-master
- LICENSE
- .readthedocs.yml
- CONTRIBUTING.md
- CHANGELOG.md
- setup.py
- mobly
  - base_instrumentation_test.py
  - keys.py
  - config_parser.py
  - suite_runner.py
  - runtime_test_info.py
  - asserts.py
  - controller_manager.py
  - expects.py
  - test_runner.py
  - controllers
    - sniffer_lib
      - __init__.py
      - local
        local_base.py
        tcpdump.py
        __init__.py
        tshark.py
    - attenuator_lib
      - minicircuits.py
      - __init__.py
      - telnet_scpi_client.py
    - monsoon.py
    - android_device.py
    - attenuator.py
    - __init__.py
    - android_device_lib
      - fastboot.py
      - services
        sl4a_service.py
        base_service.py
        logcat.py
        __init__.py
        snippet_management_service.py
      - snippet_client.py
      - jsonrpc_shell_base.py
      - adb.py
      - service_manager.py
      - event_dispatcher.py
      - callback_handler.py
      - sl4a_client.py
      - jsonrpc_client_base.py
      - __init__.py
      - errors.py
      - snippet_event.py
    - sniffer.py
    - iperf_server.py
  - logger.py
  - base_test.py
  - __init__.py
  - utils.py
  - records.py
  - signals.py
- setup.cfg
- .travis.yml
- README.md
- tests
  - lib
    - multiple_subclasses_module.py
    - mobly_sanity_test_config.yml
    - integration3_test.py
    - jsonrpc_client_test_base.py
    - mock_instrumentation_test.py
    - integration_test.py
    - mock_android_device.py
    - __init__.py
    - integration2_test.py
    - utils.py
    - mock_second_controller.py
    - teardown_class_failure_test.py
    - mock_controller.py
  - mobly
    - base_instrumentation_test_test.py
    - controller_manager_test.py
    - config_parser_test.py
    - utils_test.py
    - records_test.py
    - controllers
      - android_device_test.py
      - __init__.py
      - monsoon_test.py
      - android_device_lib
        sl4a_client_test.py
        services
        sl4a_service_test.py
        logcat_test.py
        base_service_test.py
        __init__.py
        snippet_management_service_test.py
        jsonrpc_client_base_test.py
        errors_test.py
        snippet_client_test.py
        snippet_event_test.py
        __init__.py
        jsonrpc_shell_base_test.py
        adb_test.py
        callback_handler_test.py
        service_manager_test.py
    - suite_runner_test.py
    - test_runner_test.py
    - logger_test.py
    - __init__.py
    - output_test.py
    - base_test_test.py
    - test_suite_test.py
    - asserts_test.py
  - __init__.py
- tools
  - snippet_shell.py
  - sl4a_shell.py
- .gitignore
- docs
  - Makefile
  - make.bat
  - README.sphinx
  - mobly.controllers.rst
  - android_device_service.md
  - mobly.controllers.sniffer_lib.rst
  - mobly.controllers.android_device_lib.services.rst
  - instrumentation_tutorial.md
  - mobly.controllers.attenuator_lib.rst
  - tutorial.md
  - mobly.controllers.sniffer_lib.local.rst
  - mobly.rst
  - requirements.txt
  - index.rst
  - conf.py
  - mobly.controllers.android_device_lib.rst

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.

NOTE: As part of the bigger communitiy initiative, we are planning to drop Python 2.7 support in 2020. Mobly 1.10 is likely the last major release to support Python 2.7.

Mobly tests could run on the following platforms:

Ubuntu 14.04+
MacOS 10.6+
Windows 7+

Platform	Build Status
Linux
Windows

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

Mobly 101 - Simple test examples to get you started with Mobly.
Mobly Instrumentation Runner Tutorial - How to use Mobly's Android instrumentation test runner to run Android instrumentation tests.
Mobly AndroidDevice Service - 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: 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.