galaxest is a CLI (Command Line Interface) software to help developer/tester to run automation test through any device farms agnostically.
- Mac OS / Linux Debian based
- Python 2.7
- Python PIP
- ADB properly setup
You must have all of the requirements installed first. Then you can simply install via Python PIP:
pip install galaxest
You have to setup your app after the installation success. type command below if this is your first setup:
galaxest
or you can type below command if you want to re-setup your configuration:
galaxest --reset-config
It will show a dialogue to prompt you about the setup. Choose Yes if you are ready to do the setup.
You'll be asked to choose the device farm sources available for your project. You can choose more than one device farm source if you have it. You have to type → for each options you choose until the indicator shows X while O means you are not choosing the option.
You'll need host,api key, and adb public key of the OpenSTF to make your app works with OpenSTF Device Farm.
- Please put your OpenSTF host address completely like example :
http://mystf.com:7100
- Then you have to generate your OpenSTF API Key from your OpenSTF Dashboard and put the API Key to the setup dialogue.
- Last, you need to register your ADB Public Key to your OpenSTF account in order to do remote connect and do some adb commands through the device.
- It will check if the app is able to connect to the OpenSTF Device Farm.
Next, You'll be asked to choose one automation tool that you use in your computer.
There are some questions to make galaxest working perfectly with your Katalon.
- The Katalon Application Path. You need to specify the absolute path to your katalon application. e.g:
/Applications/Katalon.app/Contents/MacOS/katalon
- Your Automation Project File. You need to specify the absolute path to your automation project file. The file should be the one which has extension .prj. e.g:
/Users/your_username/your_dir/your_automation_project_name.prj
galaxest --help
galaxest -l
If you want to connect randomly to a device:
galaxest -c
Or if you want to connect to a desired device:
galaxest -c desired_serial_id
galaxest -d desired_serial_id
galaxest -i
You can run a test by simply use this command:
galaxest -r desired_test_suite_name
You can also specify the method to find the most suitable device to run test. We currently support find a device by the id --by-id
, by the os--by-os
, and by the amount --by-n
.
galaxest -r desired_test_suite_name --by-id desired_serial_id
You can also specify more options supported from the automation framework you are using by adding --opts
.
galaxest -r <test_suite_name> --opts additional_run_options
You can run your automation test in parallel by using ,
as delimiter between specs except for --by-n
. e.g:
galaxest -r desired_test_suite_name --by-os 5,6,7
galaxest -p
galaxest --reset-config
See LICENSE.
Copyright © 2019 The galaxest Project. All Rights Reserved.