travis-saucelabs-api 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9a020d8e584148b881c96d7060206d23d527886c
-  data.tar.gz: e8280c6e4bbdd885ed75f91ba220bd4ea784e605
+  metadata.gz: 004d0cef2f71d97a858de7a543ef4b44440fbc6d
+  data.tar.gz: 74669ed6b8f114d14cd53483989134bc039bc849
 SHA512:
-  metadata.gz: ec8900ed99b31da6d0a1d4f9708f74aeaca8b2e8032d86e78a7c2ab5f02c1dd774345a8c7cde179978dce23008a73d78e8177656375f89dafb79128819459182
-  data.tar.gz: 158a5a18df2bed7ef52197ad75b6b49400537e0ed0c031e82d62a0701080adc4cf072d4509015eec6a7edc2e0e7ad668057dc5eeacc2e548f7480bbe615d3d3b
+  metadata.gz: fd22bf29beb91a8e52e0d301d46680adf22ca6eb68cd2d7e3997f9d7a44fab15fe088303745b974c9ea86cbaeedbc5912ea67002b7e08cf3d657133e0a894e07
+  data.tar.gz: 07b3e0e3706b4f60297ad8b908e45ea999fa520ed756c6867c459da0f3c6e0c1d61592b1485e727a4fca11ef809d62ff7c42eabaaa7188cc98070cde43f4deba

data/CHANGES.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## v0.0.3
+
+- Allow specifying an image when starting a VM with the CLI (using `--image`).
+- Change the default image name to `ichef-travis-osx8-latest`.
+- Raise errors on all 4xx and 5xx errors. They are raised as
+  `Travis::SaucelabsAPI::ClientError` and `Travis::SaucelabsAPI::ServerError`,
+  respectively, and both inherit from `Travis::SaucelabsAPI::Error`.
+
+## v0.0.2
+
+- Add allow_incoming endpoint, which allows for opening incoming ports in the
+  firewall (for example to SSH in from outside the LAN).
+- Require API responses to use the application/json Content-Type to be parsed as
+  JSON.
+
+## v0.0.1
+
+Initial release

data/README.md

@@ -18,10 +18,12 @@ Or install it yourself as:
 
 ## Usage
 
+### Library
+
 ``` ruby
 require 'travis-saucelabs-api'
 
-api = Travis::SaucelabsAPI.new('http://user:password@api.example.com:1234')
+api = Travis::SaucelabsAPI::Connection.new('http://user:password@api.example.com:1234')
 
 # The available capacity for the cloud
 #
@@ -58,6 +60,28 @@ api.open_outgoing('38257917-4fac-68fc-11f4-1575d2ec6847@api#vm1')
 api.save_image('38257917-4fac-68fc-11f4-1575d2ec6847@api#vm1')
 ```
 
+### CLI
+
+To use the CLI, you first need to tell it what the API endpoint is:
+
+    $ export TRAVIS_SAUCE_API_URI="http://user:password@api-endpoint:port"
+
+#### Start a new VM
+
+    $ travis-saucelabs start
+
+#### List information about all VMs
+
+    $ travis-saucelabs list
+
+#### Kill a VM
+
+    $ travis-saucelabs kill <instance-id>
+
+#### Kill all VMs belonging to a worker (by PID)
+
+    $ travis-saucelabs kill_pid <worker-pid>
+
 ## Contributing
 
 1. Fork it

data/bin/travis-saucelabs

@@ -20,8 +20,14 @@ class TravisSaucelabs < Thor
   desc 'start', 'Starts a new VM instance'
   option :hostname
   option :password
+  option :image
   def start
-    instance_id = api.start_instance(startup_info)['instance_id']
+    instance_id = if options[:image]
+      api.start_instance(startup_info, options[:image])['instance_id']
+    else
+      api.start_instance(startup_info)['instance_id']
+    end
+
     puts "Started instance with ID #{instance_id}"
     print "Allowing outgoing connections..."
     api.allow_outgoing(instance_id)

data/lib/travis-saucelabs-api.rb

@@ -4,9 +4,12 @@ require 'faraday_middleware'
 
 module Travis
   class SaucelabsAPI
-    class NotFoundError < StandardError; end
+    class Error < StandardError; end
+    class ClientError < Error; end
+    class ServerError < Error; end
+    class NotFoundError < ClientError; end
 
-    DEFAULT_IMAGE = 'ichef-osx8-10.8-travis'
+    DEFAULT_IMAGE = 'ichef-travis-osx8-latest'
 
     # Public: Initialize a new API client instance
     #
@@ -71,7 +74,14 @@ module Travis
     private
 
     def handle_response(response)
-      raise NotFoundError if response.status == 404
+      case response.status
+      when 404
+        fail NotFoundError, response.body
+      when 400...500
+        fail ClientError, response.body
+      when 500...600
+        fail ServerError, response.body
+      end
 
       response.body
     end

data/lib/travis-saucelabs-api/version.rb

@@ -1,5 +1,5 @@
 module Travis
   class SaucelabsAPI
-    VERSION = "0.0.2"
+    VERSION = "0.0.3"
   end
 end

metadata

@@ -1,55 +1,55 @@
 --- !ruby/object:Gem::Specification
 name: travis-saucelabs-api
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Henrik Hodne
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-08 00:00:00.000000000 Z
+date: 2014-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
 - !ruby/object:Gem::Dependency
   name: faraday_middleware
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0.14'
 description: Ruby client library for the API Travis uses to spin up OS X VMs
@@ -60,9 +60,10 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .rspec
-- .travis.yml
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CHANGES.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -89,17 +90,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Travis/Sauce Labs API client