Metadata-Version: 2.4
Name: mobly-android-partner-tools
Version: 1.0.0
Summary: Command-line utilities used by Android partners to run packaged Mobly tests and
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: google-api-python-client
Requires-Dist: google-auth
Requires-Dist: google-auth-httplib2
Requires-Dist: google-cloud
Requires-Dist: google-cloud-api-keys
Requires-Dist: google-cloud-resource-manager
Requires-Dist: google-cloud-storage
Requires-Dist: httplib2
Requires-Dist: mobly
Requires-Dist: pyyaml
Dynamic: license-file

# Mobly Android Partner Tools

This is a suite of command-line tools used for Android partner testing based
on the [Mobly framework](https://github.com/google/mobly).

Use cases include the [BeToCQ test suite](https://github.com/android/betocq).

## Installation instructions

**If you have already installed a test suite that includes these tools, such as
BeToCQ, you may skip these steps.**

1. Download `mobly-android-partner-tools-{version}-py3-none-any.whl` from the
   latest [release](https://github.com/android/mobly-android-partner-tools/releases).
2. Open a new terminal and run the following installation commands.

    ```bash
    # on Linux

    python3 -m venv venv
    source venv/bin/activate
    python3 -m pip install mobly-android-partner-tools-{version}-py3-none-any.whl
    ```
    ```cmd
    :: on Windows

    python -m venv venv
    venv\Scripts\activate
    python -m pip install mobly-android-partner-tools-{version}-py3-none-any.whl
    ```

## Mobly test runner

The Mobly test runner is a tool that serves as the entry point for executing a
given Mobly test or suite.

Refer to the dedicated [README](src/mobly_runner/README.md) for more details.

## Results uploader

The results uploader is a tool that allows partners to upload test results to
a shared test storage, where they may then review and debug the results with 
Google.

Refer to the dedicated [README](src/results_uploader/README.md) for more details.
