Contents

sauce
=====

Ruby access to SauceLab's features

Features
--------
Current:

*   ActiveRecord-like interface for tunnels: Find/create/destroy
*   Same with jobs

Planned:

*   Extend to automatic retrieval of jobs logs, videos, reverse tunnels
*   Start/stop local instances of Sauce RC

Install
-------
Make sure you're pulling in gems from http://rubygems.org/, and then:

`gem install sauce`

Example
-------
Here's how to start a tunnel using the Sauce gem
    require 'rubygems'
    require 'sauce'
    
    account = YAML.load_file "live_account.yml"
    client = Sauce::Client.new(:username => account["username"],
                               :access_key => account["access_key"])

    tunnel = client.tunnel.create('DomainNames' => ["example.com"])
    tunnel.refresh!
    
    client.tunnels.all # => [#<Sauce::Tunnel:0x1250e6c
                                 @host=nil,
                                 @status="running",
                                 @id="389a1c2a3d49861474c512e9a904be9e",
                                 @client=#<RestClient::Resource:0x1257fb4
                                   @block=nil,
                                   @url="https://username:[e-mail]/rest/username/",
                                   @options={}>,
                                 @owner="username">]

    tunnel.destroy

Note on Patches/Pull Requests
----------------------------- 
*   Fork the project.
*   Make your feature addition or bug fix.
*   Add tests for it. This is important so I don't break it in a future version unintentionally.
*   Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
*   Send me a pull request. Bonus points for topic branches.

Copyright
---------
Copyright (c) 2010 Sauce Labs Inc. See LICENSE for details.

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
sauce-0.5.0	README.markdown
sauce-0.4.3	README.markdown
sauce-0.4.0	README.markdown
sauce-0.3.0	README.markdown