Stf::Client

Automation client for connecting to OpenSTF devices.

Designed with the following scenario in mind:

1. Connect to remote devices
2. Do something with the device via adb (Instrumentation Test, adb install, etc)
3. Disconnect from device

Installation

Add this line to your application's Gemfile:

gem 'stf-client'

And then execute:

$ bundle

Or install it yourself as:

$ gem install stf-client

Usage

NAME
    stf-client - Smartphone Test Lab client

SYNOPSIS
    stf-client [global options] command [command options] [arguments...]

GLOBAL OPTIONS
    --help             - Show this message
    -t, --token=arg    - Authorization token, can also be set by environment variable STF_TOKEN (default: none)
    -u, --url=arg      - URL to STF, can also be set by environment variable STF_URL (default: none)
    -v, --[no-]verbose - Be verbose

COMMANDS
    clean      - Frees all devices that are assigned to current user in STF. Doesn't modify local adb
    connect    - Search for a device available in STF and attach it to local adb server
    disconnect - Disconnect device(s) from local adb server and remove device(s) from user devices in STF
    help       - Shows a list of commands or help for one command
    keys       - Show avaliable keys for filtering
    values     - Show known values for the filtering key

ENVIRONMENT VARIABLES
    STF_TOKEN - Authorization token 
    STF_URL   - URL to STF 

COMMAND OPTIONS
    connect
        -f          - Filter devices in the form of "key:value". Use stf-client keys to list keys and stf-client values -k <key from prev command> to get list of applicable values
        -d, --adb   - Automatically execute adb connect command once device acquired. Default true

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/Malinskiy/stf-client.

License

The gem is available as open source under the terms of the MIT License.