Unofficial command line client
Sauce Labs App Storage and Jobs, from your shell
Upload the .ipa and .apk files your mobile tests run against, then list, inspect and annotate the jobs those runs produce. One sauce command instead of hand-rolled curl calls.
sauce storage upload ./build/app.ipa88e3e7b1-690f-409f-ad5d-6519934c0d55sauce jobs list --limit 39f2c1a…
7b41de…
3ca908…sauce jobs edit 9f2c1a --failed --tag flaky9f2c1aTerse output: only the ids each command produced, one per line.
What it does
- 01
App Storage from the shell
Upload, download, list, describe and delete App files in Sauce Labs App Storage with one command each.
- 02
App groups and Group settings
List App groups and read or change their Group settings: Orientation, Instrumentation, Resigning or any other key.
- 03
List and inspect Jobs
List recent Virtual-device jobs or Real-device jobs and print a short Job summary for any of them.
- 04
Annotate Jobs
Set a job’s name, Tags, Visibility, Job result, Build or Custom data after it ran.
- 05
Terse, verbose or silent output
Terse output prints only ids, Verbose output the full response as JSON or YAML, and Silent mode nothing at all.
- 06
Credentials and Regions
Credentials from flags, the environment or a .env file, and one of three Sauce Labs Regions per command.
From install to first command
- Step 1
Find Credentials
Flags win over the environment:
--usernameand--access-key, elseSAUCE_USERNAMEandSAUCE_ACCESS_KEY. A.envor.env.localfile in the working directory is loaded first and never overwrites a variable that is already set. - Step 2
Pick a Region
--region, elseSAUCE_REGION, elseus-west-1. The Region selects the API host,api.<region>.saucelabs.com. - Step 3
Call the API
App Storage commands call
/v1/storage/…, Virtual-device job commands/rest/v1/<username>/jobsand Real-device job commands/v1/rdc/jobs, with HTTP basic auth. - Step 4
Print and exit
Terse output by default, the full response with
--verbose, nothing with--silent. The exit code tells a script what happened.
Script App Storage and Jobs without curl
A Node.js command line tool you run on your machine or in CI, with your own Sauce Labs account. Nothing in between.