NAME

WWW::Saucelabs - An incomplete, wip perl client to the Saucelabs REST API

VERSION

version 0.01

SYNOPSIS

my $sauce = WWW::Saucelabs->new;

my $jobs = $sauce->get_jobs({limit => 5 });
map { say $_->{id} } @$jobs;

DESCRIPTION

This module is an incomplete perl client for the Saucelabs REST API. Saucelabs provides webdriver instances for automated testing in the cloud for CI.

This module is perilously incomplete and we'd love for you to contribute. (We have no affiliation with Saucelabs other than we love using their services :D)

ATTRIBUTES

user

REQUIRED: pass in your Saucelabs user. Alternatively, you can export it to the environment variable SAUCE_USERNAME in place of specifying it during construction.

If there's no SAUCE_USERNAME environment variable, and you neglect to specify the user during construciton, we will croak.

access_key

REQUIRED: pass in your Saucelabs access key. Alternatively, you can export it to the environment variable SAUCE_ACCESS_KEY in place of specifying it during construction.

If there's no SAUCE_ACCESS_KEY environment variable, and you neglect to specify the access_key during construciton, we will croak.

METHODS

fail_job( $job_id )

Shortcut to set the status of a job to failure. $job_id should be a string.

pass_job( $job_id )

Shortcut to set the status of a job to success. $job_id should be a string.

IMPLEMENTED ENDPOINTS

get_job_assets({ job_id => $job_id })

Retrieve the assets for a given job id.

get_job_status({ job_id => $job_id })

Retrieve the status of a given job by its job_id.

get_jobs

Retrieve a list of available jobs

set_job_status({ job_id => $job_id, payload => { passed => JSON::true|JSON::false } })

Set the status of a given job to success or failure.

get_sauce_status

Get the current status of the Saucelabs service.

BUGS

Please report any bugs or feature requests on the bugtracker website https://github.com/gempesaw/saucerest-perl/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Daniel Gempesaw <gempesaw@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Daniel Gempesaw.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.